OpenRouter-API-Dokumentation

Schnellstart: Verbindung mit Python

Installieren Sie zunächst das offizielle SDK und verweisen Sie es auf unsere Basis-URL.

Unsere API verhält sich wie die Standard-OpenAI-Schnittstelle, leitet jedoch zu einem einzelnen uncensored-Modell weiter. Dieser Ansatz eliminiert die Komplexität von Proxys und erhält gleichzeitig die Portabilität Ihres Codes.

• Installieren Sie die Bibliothek über pip.
• Legen Sie Ihren API-Schlüssel in der Umgebung fest.
• Definieren Sie die Basis-URL für unseren Endpunkt.

Copyfrom openai import OpenAI

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

Ersetzen Sie den Platzhalter-Schlüssel durch Ihre eigenen Anmeldeinformationen. Sie können einfache Prompts oder komplexe strukturierte Daten senden.

Authentifizierung und Schlüssel

Generieren Sie einen Schlüssel im Dashboard und übergeben Sie ihn im Authorization-Header.

Jedes Konto unterstützt einen aktiven Schlüssel gleichzeitig. Wenn Sie einen neuen Schlüssel erstellen, funktioniert der alte sofort nicht mehr. Dies vereinfacht das Sicherheitsmanagement, ohne komplexe Rotationslogik zu erfordern.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Die obige Anfrage verwendet das Bearer-Schema. Stellen Sie sicher, dass Ihr Schlüssel mit beginnt sk- und enthält keine zusätzlichen Leerzeichen.

Chat-Vervollständigungs-Endpunkt

Senden Sie Nachrichten an den /v1/chat/completions Endpunkt unter Verwendung von Standard-JSON.

Das Modell akzeptiert user und assistant Rollen. Sie können Temperatur, top-p und Stop-Sequenzen konfigurieren, um den Ausgabestil zu steuern. Antworten geben die Token-Nutzung im letzten Chunk zurück, wenn Streaming aktiviert ist.

Copyimport OpenAI from "openai";

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

Festlegen max_tokens um die Ausgabelänge zu steuern. Wenn dieser Parameter weggelassen wird, beträgt der Standardwert 2.048 Token. Das Modell unterstützt bis zu 16.000 Token pro Anfrage.

Streaming-Antworten

Aktivieren Sie Streaming, indem Sie stream: true in Ihrem Anfragekörper.

Die Token-Nutzungsdetails erscheinen nur im letzten Chunk des Streams. Dies ermöglicht Echtzeit-UI-Aktualisierungen bei gleichzeitiger Wahrung genauer Abrechnungsdaten. Fehler während des Streamings melden dennoch die Nutzung für berechnete Tokens.

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)

Verwalten Sie partielle Antworten angemessen. Der Stream endet normal, wenn das Modell die Generierung abschließt oder das Kontextlimit erreicht.

Funktionsaufruf & JSON-Modus

Verwenden response_format: {type: "json_object"} für strikte JSON-Ausgaben.

Definieren Sie Tools in der tools Array und festlegen tool_choice um Funktionsaufrufe zu erzwingen. Das Modell gibt strukturierte Daten zurück, die für die programmatische Verarbeitung geeignet sind. Dies funktioniert zuverlässig mit unseren unzensierten Gewichten.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Kombinieren Sie den Funktionsaufruf mit Streaming für interaktive Erfahrungen. Validieren Sie die JSON-Ausgabe, bevor Sie sie an Ihre Anwendungslogik übergeben.

Limits und Quotas

Überwachen Sie Ihre Nutzung gegen die pro-Schlüssel-Limits, um Unterbrechungen zu vermeiden.

Jeder Schlüssel erlaubt 300 Anfragen pro Minute und 8 gleichzeitige Anfragen. Die Grenze für die Anfrage-Body-Größe beträgt 8 MB. Wenn Sie diese Limits überschreiten, gibt die API einen 429-Statuscode zurück. Authentifizierungsfehler geben 401 zurück, und unzureichendes Guthaben gibt 402 zurück.

Copycurl https://api.apiopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 dependencies for a Go web server"}]
  }'

Das Context-Window umfasst insgesamt 100.000 Tokens. Fehler verbrauchen kein Guthaben. Ablehnungen bei geringfügigen Inhaltsverstößen bleiben ebenfalls kostenlos.