Ein verfügbares Modell wählen
GET /v1/models mit Ihrem RouterLab-Schlüssel liefert die für Ihr Konto verfügbaren IDs. Eine öffentliche Modellseite garantiert keinen Zugriff mit Ihrem Tarif. Die Testphase ist auf Trial-Modelle begrenzt.
Protokoll · OpenAI-kompatibel
Das Format der OpenAI-Anfrage bleibt unverändert. Nur Base URL, API-Schlüssel und Modellkennung ändern sich.
Dank OpenAI-Kompatibilität können Sie SDKs und Tools weiterverwenden, die eine benutzerdefinierte Base URL akzeptieren.
Erstellen Sie im RouterLab-Dashboard einen Schlüssel und bewahren Sie ihn serverseitig auf.
Rufen Sie GET /v1/models auf, um die tatsächlich verfügbaren Modellkennungen abzurufen.
Konfigurieren Sie Ihren Client mit https://api.routerlab.ch/v1.
Verwenden Sie die genaue Modellkennung und das übliche chat/completions-Format.
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" }],
});Beginnen Sie mit einer kurzen Anfrage, prüfen Sie Antwort und Nutzung und ergänzen Sie nur die für das Modell veröffentlichten Funktionen.
GET /v1/models mit Ihrem RouterLab-Schlüssel liefert die für Ihr Konto verfügbaren IDs. Eine öffentliche Modellseite garantiert keinen Zugriff mit Ihrem Tarif. Die Testphase ist auf Trial-Modelle begrenzt.
Verwenden Sie /v1 als SDK-Basis-URL und eine exakte ID aus /v1/models. Diese Anleitung behandelt chat/completions; daraus folgt keine Unterstützung aller weiteren SDK-Endpunkte oder Parameter.
Prüfen Sie die Modell-Badges vor dem Hinzufügen von tools oder einem Ausgabeformat. Ihre Anwendung führt Tools selbst aus und validiert empfangene Daten. Die Unterstützung hängt von Modell und Route ab.
Streaming erfordert das Streaming-Badge. Eine unterbrochene Verbindung beweist keinen erfolgreichen Aufruf. Unterscheiden Sie bei 429 ein Rate Limit von einem erschöpften Budget; starten Sie eine teilweise empfangene Generierung nicht automatisch erneut.
Streaming mit dem Beispielmodell python
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["ROUTERLAB_API_KEY"], base_url="https://api.routerlab.ch/v1")
stream = client.chat.completions.create(
model="glm-5.3-flash-trial",
max_tokens=128,
messages=[{"role": "user", "content": "Hello RouterLab"}],
stream=True,
)
for part in stream:
if part.choices and part.choices[0].delta.content:
print(part.choices[0].delta.content, end="", flush=True)RouterLab vereinheitlicht den Zugriff, die Funktionen hängen jedoch weiterhin vom gewählten Modell ab.
Nachrichten, Rollen, Streaming und Tools folgen dem OpenAI-Vertrag, sofern die Route sie unterstützt.
Das Feld model muss eine Kennung enthalten, die von GET /v1/models zurückgegeben wird.
Vision, Tools, Kontext und strukturierte Ausgabe sind im Katalog angegeben.
Sie können die Modellfamilie ohne SDK-Wechsel ändern, wenn dieselbe Route verfügbar ist.
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.
Prüfen Sie zuerst den Schlüssel, die Modellkennung und das Guthaben.
| HTTP | Wahrscheinliche Ursache | Aktion |
|---|---|---|
| 400 | Ungültiger Anfragekörper oder nicht unterstützter Parameter. | Vergleichen Sie die Anfrage mit dem chat/completions-Vertrag und den Modellfunktionen. |
| 401 | Fehlender, ungültiger oder widerrufener Schlüssel. | Prüfen Sie den Authorization-Header und erstellen Sie bei Bedarf einen neuen Schlüssel. |
| 404 | Unbekannte Modellkennung. | Prüfen Sie erneut die von GET /v1/models zurückgegebene Liste. |
| 429 | Rate Limit oder verfügbares Guthaben erreicht. | Reduzieren Sie die Anfragerate und prüfen Sie die Limits im Dashboard. |
| 503 | Route vorübergehend nicht verfügbar. | Versuchen Sie es mit Backoff erneut oder wählen Sie ein anderes kompatibles Modell. |
Verwenden Sie das zweite von RouterLab dokumentierte Protokoll, statt Anfragen künstlich anzupassen.
Claude-Messages-Anleitung öffnenBesuchermessung
Dürfen Google Analytics und RouterLab öffentliche Besuche messen und die Kampagnenquelle mit Ihrer Registrierung verknüpfen? Dies ist freiwillig und jederzeit änderbar. Bei Ablehnung werden nur anonyme Besuchszahlen gespeichert.