API-Dokumentation: OpenAI-kompatible Endpunkte

Authentifizierung & Basis-URL

Greifen Sie auf die API zu, indem Sie Ihren eindeutigen Schlüssel und die Basis-URL in Ihren Umgebungsvariablen festlegen. Der Endpunkt befindet sich unter https://api.apikeykimi.com/v1. Sie müssen den Header Authorization: Bearer YOUR_API_KEY bei jeder Anfrage. Dieser Schlüssel wird sofort nach der Anmeldung über Google oder E-Mail generiert. Er ist das einzige Anmeldecredential, das für die Authentifizierung erforderlich ist. Keine Bereiche oder Berechtigungen müssen konfiguriert werden.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Chat-Vervollständigungs-Endpunkt

Senden Sie Nachrichten an das Modell mit dem standardmäßigen /v1/chat/completions Endpunkt. Geben Sie die Modell-ID als uncensored im Anfragekörper. Die API gibt generierten Text basierend auf Ihrem Prompt-Verlauf zurück. Sie können Parameter wie Temperatur und top_p anpassen, um die Kreativität zu steuern. Das Modell unterstützt Funktionsaufrufe und den JSON-Modus für strukturierte Ausgaben.

Copyfrom openai import OpenAI

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

Streaming-Antworten (SSE)

Echtzeit-Token-Bereitstellung aktivieren, indem Sie stream: true in Ihrer Anfrage. Der Server sendet einen Stream von Server-Sent Events. Jeder Chunk enthält teilweise Text, bis die Antwort vollständig ist. Dies ist ideal für Chat-Schnittstellen und Live-Coding-Anzeigen. Token-Nutzungsdetails erscheinen im letzten Chunk des Streams.

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)

Funktionsaufruf & JSON-Modus

Definieren Sie Tools oder erzwingen Sie JSON-Ausgaben über das response_format Parameter. Legen Sie json_object um gültige JSON-Antworten zu gewährleisten. Sie können auch Tool-Definitionen für Function Calling übergeben. Das Modell hält sich strikt an diese Einschränkungen. Dies ermöglicht eine zuverlässige Integration mit externen Diensten. Verwenden tool_choice die Art und Weise zu steuern, wie Tools aufgerufen werden.

Token-Limits & Einschränkungen

Der Context-Window unterstützt bis zu 100.000 Tokens für Input und Output zusammen. Die maximale Ausgabe pro Anfrage beträgt 16.000 Tokens. Wenn Sie nicht festlegen max_tokens, das Limit beträgt standardmäßig 2.048 Tokens. Anfragen sind auf einen Körper von 8 MB begrenzt. Sie sind auf 300 Anfragen pro Minute begrenzt. Pro Schlüssel können nur 8 Anfragen gleichzeitig ausgeführt werden.

Fehlerbehandlung & Nutzungslimits

Behandeln Sie Fehler durch Überprüfung des HTTP-Statuscodes. Ein 401 weist auf einen ungültigen oder abgelaufenen API-Schlüssel hin. Ein 402-Fehler bedeutet, dass Ihr vorausbezahltes Guthaben aufgebraucht ist. Eine 429-Antwort signalisiert, dass Sie das Rate Limit von 300 Anfragen pro Minute überschritten haben. Fehler und Ablehnungen verbrauchen keine Tokens. Prüfen Sie Ihr Guthaben im Dashboard, um Unterbrechungen zu vermeiden.

Node.js

Copyimport OpenAI from "openai";

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