Dolphin API-Schnellstartanleitung

Authentifizierung: Bearer-Tokens

Die Authentifizierung erfordert ein Bearer-Token, das im Authorization header.

Holen Sie sich Ihren Schlüssel vom Dashboard oder nutzen Sie das Testguthaben. Jede Anfrage muss diesen Header enthalten, um die Identität nachzuweisen.

Halten Sie den Schlüssel sicher. Teilen Sie ihn nur mit vertrauenswürdigen Diensten.

Der Endpunkt /v1/chat/completions

Dieser Endpunkt verarbeitet Texteingaben und gibt Textausgaben zurück.

Senden Sie Anfragen an https://api.whatisdolphin.com/v1 mit Ihrer Modell-ID und Nachrichten.

Verwenden Sie diese Struktur für grundlegende Interaktionen.

Streaming-Antworten mit SSE

Streaming ermöglicht die Echtzeit-Lieferung von Token über Server-Sent Events.

Festlegen stream auf true in Ihrem Anfrage-Payload.

Analysieren Sie die Chunks bei Ankunft, um eine kontinuierliche Ausgabe zu erstellen.

Function Calling und JSON-Modus

Function Calling ermöglicht es Modellen, Tools basierend auf Ihren Anweisungen auszuführen.

Verwenden Sie den JSON-Modus, um eine strenge Schema-Konformität für strukturierte Daten durchzusetzen.

Definieren Sie Tools in der Anfrage, um das Verhalten des Modells zu steuern.

Kontextfenster und Token-Grenzen

Das Kontextfenster unterstützt insgesamt 100.000 Tokens.

Ausgabelimits variieren: Setzen Sie max_tokens für Kontrolle, andernfalls auf 2.048 Tokens standardmäßig.

Verwalten Sie die Eingabelänge, um innerhalb der Grenzen für optimale Leistung zu bleiben.

Ratenbegrenzungen und Fehlerbehandlung

Rate-Limits erlauben 300 Anfragen pro Minute pro Schlüssel.

Behandeln Sie 401-Fehler für ungültige Schlüssel und 429 für Rate Limits.

Nutzung überwachen, um Dienstunterbrechungen bei hohem Volumen zu vermeiden.

cURL

Copycurl https://api.whatisdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Define what a dolphin is in two lines."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.whatisdolphin.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.whatisdolphin.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)