Protokoll · Claude Messages

Claude Messages API mit RouterLab

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.

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 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())

Vom ersten Aufruf zur Anwendung

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.

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.

Das Protokoll beachten

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.

Tools und strukturierte Ausgaben

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.

Stream-Ende und Budget prüfen

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}'

Illustrative Antwort

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
  }
}

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 x-api-key und anthropic-version wie in den Beispielen dieser Seite.
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.

Offizielle Referenzen

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.

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

Besuchermessung

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.