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 · Claude Messages
Verbinden Sie Ihre Anwendung über einen RouterLab-Schlüssel mit POST /v1/messages. Claude Messages bezeichnet das Protokoll; wählen Sie separat ein kompatibles Modell im Katalog und prüfen Sie Ihren Zugriff mit GET /v1/models. Eine öffentliche Modellseite garantiert keinen Kontozugriff.
Verwenden Sie diese Route nur für Modelle, bei denen im Katalog das Badge Claude Messages angezeigt wird.
Erstellen Sie einen RouterLab-Schlüssel und speichern Sie ihn serverseitig in einer Umgebungsvariable.
Wählen Sie im Katalog ein Modell, das ausdrücklich mit Claude Messages kompatibel ist.
Senden Sie model, max_tokens und messages im Messages-Format.
Lesen Sie die von der Route zurückgegebenen content-Blöcke und Nutzungsinformationen.
Diese Beispiele verwenden anthropic-version: 2023-06-01, den aktuell von RouterLab veröffentlichten Vertrag. Installieren Sie das Anthropic-Python-SDK 1.x (anthropic>=1,<2): Hauptversion 2 verwendet standardmäßig die neuere API-Version 2026-10-21. Setzen Sie ROUTERLAB_API_KEY in der Serverumgebung; die Messages-SDK-Basis-URL enthält kein /v1.
Python SDK 1.x shell
python -m pip install "anthropic>=1,<2"Python · Anthropic SDK 1.x python
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["ROUTERLAB_API_KEY"],
base_url="https://api.routerlab.ch",
max_retries=0,
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=128,
messages=[{"role": "user", "content": "Hello RouterLab"}],
)
text = "".join(block.text for block in message.content if block.type == "text")
print(text)
print("input_tokens:", message.usage.input_tokens)
print("output_tokens:", message.usage.output_tokens)cURL shell
curl https://api.routerlab.ch/v1/messages \
-H "x-api-key: $ROUTERLAB_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":128,"messages":[{"role":"user","content":"Hello RouterLab"}]}'TypeScript · fetch typescript
const response = await fetch("https://api.routerlab.ch/v1/messages", {
method: "POST",
headers: {
"x-api-key": process.env.ROUTERLAB_API_KEY!,
"anthropic-version": "2023-06-01",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "claude-sonnet-5-5",
max_tokens: 512,
messages: [{ role: "user", content: "Hello" }],
}),
});
if (!response.ok) throw new Error("HTTP " + response.status);
const data = await response.json();
const text = data.content.filter((block: { type: string }) => block.type === "text")
.map((block: { text: string }) => block.text).join("");
console.log(text, data.usage);Python · requests python
import os
import requests
response = requests.post(
"https://api.routerlab.ch/v1/messages",
headers={"x-api-key": os.environ["ROUTERLAB_API_KEY"], "anthropic-version": "2023-06-01"},
json={
"model": "claude-sonnet-5-5",
"max_tokens": 512,
"messages": [{"role": "user", "content": "Hello"}],
},
)
response.raise_for_status()
print(response.json())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.
POST /v1/messages verwendet x-api-key, anthropic-version und max_tokens. Ändern Sie nicht nur den Pfad einer chat/completions-Anfrage: Antwortblöcke und Tools haben ein anderes Format.
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 shell
curl -N https://api.routerlab.ch/v1/messages \
-H "x-api-key: $ROUTERLAB_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":128,"messages":[{"role":"user","content":"Hello RouterLab"}],"stream":true}'Strukturbeispiel ohne echten Aufruf: Text und Zähler sind fiktiv. Die Antwort kann mehrere Blöcke enthalten; extrahieren Sie nur text-Blöcke und lesen Sie usage.input_tokens sowie usage.output_tokens. Ein tool_use-Block erfordert die Ausführung in Ihrer Anwendung und eine tool_result-Antwort; er ist kein Anzeigetext.
HTTP 200 · application/json json
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5-5",
"content": [
{
"type": "text",
"text": "Hello! How can I help?"
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 8,
"output_tokens": 12
}
}Claude Messages ist ein Austauschformat. Das Modell bleibt eine separate Wahl, die über seine Kennung und Funktionen gesteuert wird.
Die Anfrage verwendet messages, max_tokens und die von diesem Protokoll erwarteten Inhaltsblöcke.
Verwenden Sie nur Modelle, die im Katalog das Badge Claude Messages tragen.
Tools, Vision, Kontext und Reasoning hängen vom gewählten Modell ab.
Wenn Ihr SDK chat/completions erwartet, verwenden Sie die Anleitung für die OpenAI-kompatible API.
Verwenden Sie für Claude Code den ScioNos Wrapper: Er konfiguriert Terminal und Authentifizierung. Diese Seite dokumentiert weiterhin die direkte HTTP-API.
Prüfen Sie zuerst das Messages-Format und die Routenkompatibilität des Modells.
| HTTP | Wahrscheinliche Ursache | Aktion |
|---|---|---|
| 400 | Pflichtfeld fehlt oder Inhalt ist fehlerhaft formatiert. | Prüfen Sie insbesondere model, max_tokens und messages. |
| 401 | Fehlender, ungültiger oder widerrufener Schlüssel. | Prüfen Sie x-api-key und anthropic-version wie in den Beispielen dieser Seite. |
| 404 | Unbekanntes oder nicht verfügbares Modell. | Wählen Sie eine von GET /v1/models bereitgestellte Kennung. |
| 429 | Rate Limit oder Guthabenlimit erreicht. | Reduzieren Sie die Anfragerate und prüfen Sie Ihr RouterLab-Konto. |
| 503 | Route vorübergehend nicht verfügbar. | Versuchen Sie es mit Backoff erneut oder wählen Sie eine andere kompatible Route. |
Die Anthropic-Dokumentation beschreibt Protokoll und SDK. Auf RouterLab gelten die für Route und Modell veröffentlichten Funktionen; Beta-, Batch-, Datei-APIs und gehostete Tools sind durch Messages-Kompatibilität nicht garantiert.
ScioNos ist die spezielle Integration für Coding-Agenten im Terminal. Dadurch müssen Sie deren Konfiguration nicht manuell nachbauen.
Agenten mit ScioNos konfigurierenBesuchermessung
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.