OpenAI-kompatible API-Dokumentation

Authentifizierung und Basis-URL-Einrichtung

Ihr API-Schlüssel authentifiziert jede Anfrage an unsere Server. Melden Sie sich einfach mit Google oder einer E-Mail-Adresse an und kopieren Sie den Schlüssel aus Ihrem Dashboard. Fügen Sie ihn als Umgebungsvariable ein als DEEPSEEK_API_KEY und zeigen Sie Ihren Client auf https://api.keyapideepseek.com/v1. Diese Basis-URL funktioniert mit jeder Standard-OpenAI-kompatiblen Bibliothek.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

Sie können Ihre Einrichtung überprüfen, indem Sie verfügbare Modelle auflisten. Die Antwort bestätigt, dass Ihr Schlüssel gültig und aktiv ist. Dieser Schritt stellt sicher, dass Ihre Integration auf den richtigen ungefilterten Endpunkt verweist, bevor Sie Eingaben senden.

Chat-Vervollständigungs-Endpunkt

The POST /v1/chat/completions Der Endpunkt akzeptiert Ihre Eingabe und gibt die Modellantwort zurück. Sie senden einen JSON-Body, der Nachrichten, Ihre Systemanweisungen und Parameter wie Temperatur enthält. Die Modell-ID ist immer uncensored. Dieses einzelne Modell verarbeitet alle Ihre Textgenerierungsbedürfnisse ohne Routing-Komplexität.

Copyfrom openai import OpenAI

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

Das Python-SDK übernimmt die HTTP-Anfragen automatisch. Sie übergeben Ihren Schlüssel und die Basis-URL an den Client-Konstruktor. Der Rest des Codes spiegelt die Standardmuster von OpenAI wider. Dies stellt sicher, dass Sie Anbieter später wechseln können, ohne Ihre gesamte Anwendungslogik neu schreiben zu müssen.

Streaming-Antworten und Token-Nutzung

Aktivieren Sie Streaming, indem Sie stream: true in Ihrer Anfrage. Die API gibt einen Server-Sent Events (SSE)-Stream von Chunks zurück. Jeder Chunk enthält partiellen Text und Nutzungsstatistiken. Der letzte Chunk enthält die gesamten Token-Anzahlen für die Anfrage.

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)

Streaming reduziert die wahrgenommene Latenz für Nutzer. Sie können Tokens anzeigen, sobald sie eintreffen. Dies ist entscheidend für die Generierung langer Texte oder interaktive Chat-Schnittstellen. Überwachen Sie die Token-Nutzung im letzten Chunk, um den Verbrauch Ihres Prepaid-Guthabens genau zu verfolgen.

JSON-Modus und Funktionsaufruf

Erzwingen Sie strukturierte Ausgabe durch Festlegen response_format zu {"type": "json_object"}. Das Modell gibt gültiges JSON anstelle von Freitext zurück. Dies ist ideal für API-Integrationen oder Datenextraktionsaufgaben. Sie können auch Funktionsdefinitionen in Ihrem Prompt für die Tool-Nutzung definieren.

Das Modell unterstützt tool_choice Parameter. Sie können spezifische Funktionen erzwingen oder das Modell entscheiden lassen. Diese Flexibilität ermöglicht es Ihnen, komplexe Agenten zu erstellen. Stellen Sie sicher, dass Ihre Funktionsschemata streng typisiert sind, um Parsing-Fehler in Ihrem Client-Code zu vermeiden.

Ratenbegrenzungen und Parallelität

Jeder API-Schlüssel ist auf 300 Anfragen pro Minute begrenzt. Sie können bis zu 8 gleichzeitige Anfragen aktiv haben. Die maximale Größe des Anfragekörpers beträgt 8 MB. Diese Limits verhindern Missbrauch und gewährleisten eine stabile Leistung für alle Benutzer. Das Überschreiten dieser Limits führt zu einem 429-Fehler.

Implementieren Sie exponentielles Backoff in Ihrem Client-Code. Wiederholen Sie fehlgeschlagene Anfragen nach einer kurzen Verzögerung. Dies behandelt vorübergehende Netzwerkprobleme graceful. Ihr prepaid Guthaben wird nur für erfolgreiche Abschlüsse belastet, nicht für durch Rate-Limits ausgelöste Wiederholungen.

Fehlerbehandlung und Ablehnungen

Ein 401-Fehler bedeutet, dass Ihr Schlüssel ungültig oder abgelaufen ist. Ein 402-Fehler zeigt unzureichendes vorgeladenes Guthaben an. Ein 429-Fehler signalisiert, dass Sie das Rate-Limit erreicht haben. Das Modell lehnt Anfragen ab, die sexuelle Inhalte mit Minderjährigen enthalten. Alle anderen rechtmäßigen Erwachseneninhalte sind erlaubt.

Prüfen Sie den Antworttext auf Fehler für detaillierte Meldungen. Protokollieren Sie diese Fehler, um Integrationsprobleme zu debuggen. Ihr Guthaben wird für fehlgeschlagene Anfragen nicht verbraucht. Dieses transparente Abrechnungsmodell hilft Ihnen, Kosten genau vorherzusagen, ohne versteckte Gebühren.

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapideepseek.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);