RouterLab

Protokoll · Claude Messages

Senden Sie Anfragen im Claude-Messages-Format.

Diese Route ist für Clients bestimmt, die den Messages-Vertrag nativ erzeugen. Sie bedeutet nicht, dass alle Modelle im Katalog Claude-Modelle sind.

Modelle ansehenKostenlos testen
Anfragevertragbereit
Base URL
https://api.routerlab.ch
Endpoint
POST /v1/messages
Authentifizierung
x-api-key: $ROUTERLAB_API_KEY · anthropic-version: 2023-06-01
Modellkennungen
GET /v1/models

In vier Schritten starten

Verwenden Sie diese Route nur für Modelle, bei denen im Katalog das Badge Claude Messages angezeigt wird.

  1. 01

    Schlüssel erstellen

    Erstellen Sie einen RouterLab-Schlüssel und speichern Sie ihn serverseitig in einer Umgebungsvariable.

  2. 02

    Route prüfen

    Wählen Sie im Katalog ein Modell, das ausdrücklich mit Claude Messages kompatibel ist.

  3. 03

    Nachricht aufbauen

    Senden Sie model, max_tokens und messages im Messages-Format.

  4. 04

    Antwort verarbeiten

    Lesen Sie die von der Route zurückgegebenen content-Blöcke und Nutzungsinformationen.

Anpassbare Beispiele

Diese Beispiele verwenden den RouterLab-Vertrag, der derzeit unter /v1/messages verfügbar ist.

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-trial","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-trial",
    max_tokens: 512,
    messages: [{ role: "user", content: "Hello" }],
  }),
});

const data = await response.json();

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-trial",
        "max_tokens": 512,
        "messages": [{"role": "user", "content": "Hello"}],
    },
)
response.raise_for_status()
print(response.json())

Wofür diese Route steht

Claude Messages ist ein Austauschformat. Das Modell bleibt eine separate Wahl, die über seine Kennung und Funktionen gesteuert wird.

Messages-Format

Die Anfrage verwendet messages, max_tokens und die von diesem Protokoll erwarteten Inhaltsblöcke.

Deklarierte Route

Verwenden Sie nur Modelle, die im Katalog das Badge Claude Messages tragen.

Variable Funktionen

Tools, Vision, Kontext und Reasoning hängen vom gewählten Modell ab.

Weiteres Protokoll verfügbar

Wenn Ihr SDK chat/completions erwartet, verwenden Sie die Anleitung für die OpenAI-kompatible API.

Claude Code verwendet ScioNos

Verwenden Sie für Claude Code den ScioNos Wrapper: Er konfiguriert Terminal und Authentifizierung. Diese Seite dokumentiert weiterhin die direkte HTTP-API.

Häufige Fehler

Prüfen Sie zuerst das Messages-Format und die Routenkompatibilität des Modells.

HTTPWahrscheinliche UrsacheAktion
400Pflichtfeld fehlt oder Inhalt ist fehlerhaft formatiert.Prüfen Sie insbesondere model, max_tokens und messages.
401Fehlender, ungültiger oder widerrufener Schlüssel.Prüfen Sie den Bearer-Wert im Authorization-Header.
404Unbekanntes oder nicht verfügbares Modell.Wählen Sie eine von GET /v1/models bereitgestellte Kennung.
429Rate Limit oder Guthabenlimit erreicht.Reduzieren Sie die Anfragerate und prüfen Sie Ihr RouterLab-Konto.
503Route vorübergehend nicht verfügbar.Versuchen Sie es mit Backoff erneut oder wählen Sie eine andere kompatible Route.

Benötigen Sie Claude Code oder Codex CLI?

ScioNos ist die spezielle Integration für Coding-Agenten im Terminal. Dadurch müssen Sie deren Konfiguration nicht manuell nachbauen.

Agenten mit ScioNos konfigurieren