API-Dokumentation

Basis-URL und Authentifizierung

Der API-Endpunkt befindet sich unter https://api.openrouteraiapi.com/v1. Übergeben Sie Ihren API-Schlüssel im Authorization header als Bearer-Token. Dies ist die einzige Änderung, die erforderlich ist, um den Verkehr von Ihrem aktuellen Anbieter zu unserem unzensierten Modell umzuleiten.

Die Authentifizierung ist streng. Wenn der Schlüssel fehlt oder ungültig ist, gibt der Server sofort einen 401-Fehler zurück. Sie können einen Schlüssel sofort über Google oder E-Mail im Dashboard generieren. Bewahren Sie den Schlüssel sicher auf, da er Zugriff auf Ihr vorausbezahltes Guthaben gewährt.

Chat-Vervollständigungs-Endpunkt

Senden Sie POST-Anfragen an /v1/chat/completions mit einem Nachrichten-Array. Die Modellkennung ist uncensored. Dieses einzelne Modell verarbeitet alle Ihre Textgenerierungsbedürfnisse ohne komplexe Routing-Logik.

Hier ist eine Standardanfrage mit cURL, um die Konnektivität und das Antwortformat zu überprüfen.

Copycurl https://api.openrouteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the top five python libraries for data science"}]
  }'

Die Antwort enthält den generierten Text in der choices[0].message.content Feld. Sie können dies direkt in Ihren Anwendungsarbeitsablauf parsen.

Python SDK-Integration

Verwenden Sie den offiziellen OpenAI Python-Client für eine mühelose Verbindung. Legen Sie den base_url und api_key Variablen, um auf unsere Infrastruktur zu verweisen. Dieser Ansatz minimiert Code-Änderungen beim Wechseln von Anbietern.

Copyfrom openai import OpenAI

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

Der Client verarbeitet Serialisierung und Retries automatisch. Sie erhalten ein Completion-Objekt, das den Text und die Token-Nutzungsstatistiken enthält. Diese Methode ist ideal für Backend-Dienste und Skripte.

Node.js-SDK-Nutzung

Initialisieren Sie den OpenAI Node.js-Client mit Ihrer benutzerdefinierten Basis-URL. Dies ermöglicht es JavaScript-Anwendungen, mit dem unzensierten Modell über vertraute Methoden zu interagieren. Das SDK verarbeitet die HTTP-Anfragen effizient.

Copyimport OpenAI from "openai";

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

Anruf chat.completions.create() mit Ihren Nachrichten. Das Antwortobjekt bietet Zugriff auf den generierten Inhalt und die Nutzungsdaten. Diese Integration eignet sich gut für Webserver und Edge-Funktionen.

Streaming-Antworten

Aktivieren Sie Streaming, indem Sie stream: true in Ihrer Anfrage. Der Server sendet Server-Sent Events (SSE) für die Echtzeit-Übertragung von Tokens. Dieses Feature reduziert die wahrgenommene Latenz für Endbenutzer.

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)

Jeder Chunk enthält teilweise Inhalte. Der letzte Chunk enthält die vollständigen Token-Nutzungsstatistiken. Verarbeiten Sie diese Ereignisse in Ihrem Client, um die Benutzeroberfläche inkrementell zu aktualisieren.

Limits, Fehler und Kontextfenster

Das Context-Window unterstützt 100.000 Tokens für kombinierte Eingabe und Ausgabe. Jede Anfrage kann bis zu 16.000 Tokens ausgeben bzw. 2.048, wenn max_tokens ist nicht festgelegt. Die Ratenbegrenzung erlaubt 300 Anfragen pro Minute pro Schlüssel.

Fehler sind standardmäßige HTTP-Codes. Ein 401 zeigt einen ungültigen Schlüssel an. Ein 402 bedeutet, dass Ihr prepaid-Guthaben aufgebraucht ist. Ein 429 signalisiert, dass Sie das Rate Limit überschritten haben. Fehlgeschlagene Anfragen verbrauchen kein Guthaben. Fehler sind kostenlos.