Schnellstart-Guide für Entwickler

Voraussetzungen: Ihr API-Schlüssel

Generieren Sie Ihren key sofort nach dem Anmelden. Besuchen Sie die Seite „API-Schlüssel erhalten“ und authentifizieren Sie sich mit Google oder einem E-Mail-Passwort. Die Schnittstelle zeigt Ihren eindeutigen Schlüssel sofort an, ohne dass eine Telefonnummer erforderlich ist. Bewahren Sie diese Zeichenfolge sicher auf, da sie alle Anfragen an die Basis-URL authentifiziert. Sie erhalten automatisch $0.50 Testguthaben, das nach sieben Tagen verfällt, wenn es nicht genutzt wird.

Konfigurieren von Cursor für OpenAI-Kompatibilität

Richten Sie Ihren Client auf unseren spezifischen Endpunkt aus, um eine korrekte Weiterleitung zu gewährleisten. Legen Sie die Basis-URL auf HTTPS://api.keyapicursor.com/v1 fest und fügen Sie Ihren Schlüssel in den Autorisierungsheader ein. Diese Konfiguration funktioniert mit jedem Standard-OpenAI-kompatiblen SDK, ohne den Modellnamen zu ändern. Sie müssen die Modellkennung als uncensored angeben, um die Open-Weight-Ausgabe zu erhalten.

Ihre erste Anfrage senden

Führen Sie eine einfache Vervollständigung aus, um Konnektivität und Latenz zu überprüfen. Verwenden Sie den folgenden curl-Befehl, um eine grundlegende Eingabeaufforderung an den Chat-Vervollständigungs-Endpunkt zu senden. Die Antwort gibt ein JSON-Objekt zurück, das den generierten Text enthält. Überprüfen Sie das Feld „usage“, um zu bestätigen, dass der Token-Verbrauch Ihren Erwartungen entspricht.

Streaming-Antworten handhaben

Streamen Sie Tokens für geringere wahrgenommene Latenz in interaktiven Anwendungen. Der Server sendet Server-Sent Events, die teilweise Delta-Werte enthalten, bis der letzte Chunk die gesamten Nutzungsdaten enthält. Analysieren Sie diese Events, um Ihre Benutzeroberfläche in Echtzeit zu aktualisieren. Diese Methode funktioniert identisch auf Python- und Node-Clients.

Integration mit Python- und Node-SDKs

Wiederverwenden Sie bestehende Codebasen, indem Sie nur die Basis-URL und die Schlüsselparameter anpassen. Das Python-Beispiel zeigt die direkte Integration mit der offiziellen Client-Bibliothek. Das Node-Beispiel folgt demselben Muster für JavaScript-Umgebungen. Beide Methoden unterstützen JSON-Modus und Function Calling out of the box.

Verständnis der Ratenbegrenzungen und Tokens

Überwachen Sie Ihr Anfragevolumen, um Serviceunterbrechungen bei starker Nutzung zu vermeiden. Das System erzwingt ein Limit von 300 Anfragen pro Minute pro Schlüssel. Sie können acht gleichzeitige Anfragen mit einem Anfragekörper von 8 MB ausführen. Fehler wie 401 ungültige Schlüssel oder 402 unzureichendes Guthaben verbrauchen nicht Ihr Guthaben im Voraus.

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

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