Dolphin Unzensiert API Dokumentation

Voraussetzungen und Umgebungseinrichtung

Stellen Sie zunächst sicher, dass Ihre Umgebung die erforderlichen Abhängigkeiten installiert hat, bevor Sie Anfragen senden. Sie benötigen einen aktiven API-Schlüssel von unserem Dashboard und eine unterstützte Laufzeitumgebung wie Python oder Node.js. Unsere API erfordert, dass Sie Anfragen an eine bestimmte Basis-URL senden, anstatt den Standard-OpenAI-Endpunkt zu verwenden.

Bewahren Sie Ihren API-Schlüssel sicher auf und speichern Sie ihn in einer Umgebungsvariable. Dies verhindert eine unbeabsichtigte Offenlegung in Ihrem Code-Repository. Sie können sofort nach der Anmeldung mit Google oder E-Mail einen neuen Schlüssel generieren.

Sie müssen kein komplexes Routing konfigurieren oder spezifische Modelle auswählen. Der Endpunkt dient einem einzelnen unzensierten Large Language Model, das für direkte Textausgabe entwickelt wurde.

Installation des offiziellen OpenAI-SDK

Installieren Sie das offizielle SDK-Paket, um die Authentifizierung und die Anfrageformatierung automatisch zu verarbeiten. Diese Bibliothek unterstützt sowohl Python- als auch Node.js-Umgebungen mit konsistenten Schnittstellen.

Für Python-Benutzer führen Sie den Standard-pip-Install-Befehl aus, um die Bibliothek zu Ihrer virtuellen Umgebung hinzuzufügen. Node.js-Entwickler sollten npm verwenden, um das entsprechende Paket zu installieren.

Das SDK verwaltet die JSON-Payload-Struktur für Sie, sodass Sie sich nur auf den Prompt-Inhalt und Parameter wie Temperatur oder top_p konzentrieren müssen.

Sie können die Installation überprüfen, indem Sie die Bibliothek in Ihrem Skript oder Modul importieren. Dies stellt sicher, dass der Client bereit ist, sich mit unseren Servern zu verbinden.

Konfigurieren der Basis-URL und des API-Schlüssels

Richten Sie Ihren SDK-Client auf unsere spezifische Basis-URL, um Anfragen an unsere unzensierte Infrastruktur zu leiten. Verwenden https://api.dolphinuncensored.com/v1 als Ihren Endpunkt.

Legen Sie Ihren API-Schlüssel im Authorization-Header oder im Client-Konfigurationsobjekt fest. Der Client hängt diesen Schlüssel automatisch an jede Anfrage an.

Stellen Sie sicher, dass Sie die Modell-ID als "uncensored" in Ihrer Konfiguration angeben. Dies teilt dem Server mit, welche Modellversion für Ihre Generierung verwendet werden soll.

Ihre erste Chat-Antwort erstellen

Sende eine einfache Nachricht, um die Konnektivität zu überprüfen und eine Antwort zu erhalten. Dies bestätigt, dass dein Schlüssel gültig ist und der Endpunkt erreichbar ist.

Verwenden Sie den Chat-Completions-Endpunkt mit einer Systemanweisung und einer Benutzernachricht. Die Antwort enthält den generierten Text im Feld „content“.

Verständnis von Streaming und Token-Nutzung

Streaming aktivieren, um Tokens sofort bei ihrer Generierung zu empfangen, anstatt auf die vollständige Antwort zu warten. Dies verbessert die wahrgenommene Latenz für lange Ausgaben.

Die API gibt Nutzungsstatistiken im letzten Chunk des Streams zurück. Sie können Token-Anzahlen für Eingabe und Ausgabe zur Abrechnungstransparenz verfolgen.

Legen Sie den Parameter stream auf true im Anfragekörper fest. Durchlaufen Sie die Chunks, um Ihren endgültigen Text zu erstellen oder ihn in Echtzeit zu verarbeiten.

Verarbeitung von Fehlern und Ablehnungen

Behandeln Sie HTTP-401-Fehler durch Überprüfung, ob Ihr API-Schlüssel korrekt und nicht abgelaufen ist. Ein 402-Fehler zeigt unzureichendes vorausbezahltes Guthaben an; laden Sie per Krypto nach, um fortzufahren.

Ein 429-Status bedeutet, dass Sie das Limit von 300 Anfragen pro Minute erreicht haben. Warten Sie kurz, bevor Sie es erneut versuchen, oder reduzieren Sie Ihre Parallelität.

Das Modell lehnt Anfragen mit sexuellem Inhalt mit Minderjährigen ab, was eine harte Grenze ist. Andere kontroverse oder erwachsene Themen sind im Allgemeinen erlaubt. Fehler und Ablehnungen verbrauchen nicht Ihr Token-Guthaben.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinuncensored.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinuncensored.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Streaming

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)