Protokoll · OpenAI-kompatibel

Verbinden Sie Ihren OpenAI-Client mit RouterLab.

Das Format der OpenAI-Anfrage bleibt unverändert. Nur Base URL, API-Schlüssel und Modellkennung ändern sich.

Anfragevertragbereit
Base URL
https://api.routerlab.ch/v1
Endpoint
POST /v1/chat/completions
Authentifizierung
Authorization: Bearer $ROUTERLAB_API_KEY
Modellkennungen
GET /v1/models

In vier Schritten starten

Dank OpenAI-Kompatibilität können Sie SDKs und Tools weiterverwenden, die eine benutzerdefinierte Base URL akzeptieren.

  1. 01

    Schlüssel erstellen

    Erstellen Sie im RouterLab-Dashboard einen Schlüssel und bewahren Sie ihn serverseitig auf.

  2. 02

    Modelle auflisten

    Rufen Sie GET /v1/models auf, um die tatsächlich verfügbaren Modellkennungen abzurufen.

  3. 03

    Base URL ändern

    Konfigurieren Sie Ihren Client mit https://api.routerlab.ch/v1.

  4. 04

    Anfrage senden

    Verwenden Sie die genaue Modellkennung und das übliche chat/completions-Format.

Anpassbare Beispiele

Derselbe Vertrag funktioniert sowohl über direktes HTTP als auch mit dem OpenAI-SDK.

cURL shell

curl https://api.routerlab.ch/v1/chat/completions \
  -H "Authorization: Bearer $ROUTERLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3-flash-trial","max_tokens":128,"messages":[{"role":"user","content":"Hello RouterLab"}]}'

Python · OpenAI SDK python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ROUTERLAB_API_KEY"],
    base_url="https://api.routerlab.ch/v1",
)

response = client.chat.completions.create(
    model="glm-5.3-flash-trial",
    max_tokens=128,
    messages=[{"role": "user", "content": "Hello RouterLab"}],
)
print(response.choices[0].message.content)

TypeScript · OpenAI SDK typescript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ROUTERLAB_API_KEY,
  baseURL: "https://api.routerlab.ch/v1",
});

const response = await client.chat.completions.create({
  model: "glm-5.3-flash-trial",
  messages: [{ role: "user", content: "Hello" }],
});

Was die Kompatibilität gewährleistet

RouterLab vereinheitlicht den Zugriff, die Funktionen hängen jedoch weiterhin vom gewählten Modell ab.

Gleiches Anfrageformat

Nachrichten, Rollen, Streaming und Tools folgen dem OpenAI-Vertrag, sofern die Route sie unterstützt.

RouterLab-Kennungen

Das Feld model muss eine Kennung enthalten, die von GET /v1/models zurückgegeben wird.

Funktionen pro Modell

Vision, Tools, Kontext und strukturierte Ausgabe sind im Katalog angegeben.

Austauschbare Familien

Sie können die Modellfamilie ohne SDK-Wechsel ändern, wenn dieselbe Route verfügbar ist.

DeepSeek und GLM sind keine neuen APIs

Es handelt sich um Modellfamilien. Behalten Sie diese Integration bei und ändern Sie nur den Wert im Feld model. Prüfen Sie immer die Route-Badges im Katalog.

Häufige Fehler

Prüfen Sie zuerst den Schlüssel, die Modellkennung und das Guthaben.

HTTPWahrscheinliche UrsacheAktion
400Ungültiger Anfragekörper oder nicht unterstützter Parameter.Vergleichen Sie die Anfrage mit dem chat/completions-Vertrag und den Modellfunktionen.
401Fehlender, ungültiger oder widerrufener Schlüssel.Prüfen Sie den Authorization-Header und erstellen Sie bei Bedarf einen neuen Schlüssel.
404Unbekannte Modellkennung.Prüfen Sie erneut die von GET /v1/models zurückgegebene Liste.
429Rate Limit oder verfügbares Guthaben erreicht.Reduzieren Sie die Anfragerate und prüfen Sie die Limits im Dashboard.
503Route vorübergehend nicht verfügbar.Versuchen Sie es mit Backoff erneut oder wählen Sie ein anderes kompatibles Modell.

Verwendet Ihr Tool Claude Messages?

Verwenden Sie das zweite von RouterLab dokumentierte Protokoll, statt Anfragen künstlich anzupassen.

Claude-Messages-Anleitung öffnen