Claude Sonnet 5.5

Verwenden Sie claude-sonnet-5-5 mit dem Anthropic-Messages-Format. Dieses Dokument unterscheidet zwischen der offiziellen Anfragespezifikation und dem Verhalten, das in Kompatibilitätstests beobachtet wurde. Einige erweiterte Optionen funktionieren derzeit noch nicht wie spezifiziert. Prüfen Sie die Einschränkungen, bevor Sie sich darauf verlassen.

Die aktuellen Preise für Eingabe, Ausgabe und Cache finden Sie auf der Modellseite.

Schnellstart

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain how a rainbow forms in three sentences."}]
  }'

POST /v1/messages akzeptiert die Authentifizierung per x-api-key oder Bearer sowie anthropic-version: 2023-06-01. Senden Sie einen anthropic-beta-Header für Funktionen, deren offizielle Dokumentation diesen voraussetzt. Bewahren Sie Zugangsdaten im serverseitigen Code auf.

Das Modell akzeptiert auch grundlegende Anfragen für OpenAI Chat Completions (POST /v1/chat/completions) und Responses (POST /v1/responses). Verwenden Sie Messages für die unten beschriebenen nativen Parameter. Die Konvertierung des OpenAI-Formats stellt nicht jede Anthropic-Funktion bereit.

Offizielle Parameterspezifikation

Sonnet 5.5 hat ein Kontextfenster von 1M Token und ein Ausgabelimit von 128000 Token für synchrone Anfragen. Batch-spezifische Ausgabelimits gelten nicht für diesen Endpunkt. Sofern die Tabelle nichts anderes angibt, setzt die Anwendung für optionale Eigenschaften keinen Standardwert.

between_tools akzeptiert nur seine Eigenschaft type und den Denkaufwand low, medium oder high. Senden Sie dabei kein display, budget_tokens oder block_binding. Beispiel:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}

Assistant-Prefilling wird nicht unterstützt. Um einen pause_turn fortzusetzen, senden Sie den zurückgegebenen Assistant-Inhalt des Server-Tools unverändert erneut. Die Komprimierung fasst den vorhandenen Verlauf zusammen und ist kein Assistant-Prefill. Bewahren Sie Denkblöcke und Signaturen exakt auf. Verschieben Sie diese nicht zwischen Modellen und bearbeiten Sie keinen früheren Verlauf, ohne die offiziellen Bindungsregeln einzuhalten.

In der nativen Claude API erfordert die Computernutzung computer_toolset_20260801; computer_20251124 wird abgelehnt. Advisor-Konfigurationen mit claude-opus-4-8, claude-opus-4-7 oder claude-sonnet-5 werden für dieses ausführende Modell ebenfalls abgelehnt.

Fallback-Anfragefelder

Die offizielle Beta-Funktion fallbacks wiederholt Anfragen bei dafür vorgesehenen Ablehnungen durch den Klassifikator. Sie wiederholt keine Anfragen bei Ratenlimits, Überlastung oder Serverfehlern. Eine Ablehnung kann weiterhin bestehen bleiben. Senden Sie server-side-fallback-2026-07-01 für "default" oder eine explizite Liste; server-side-fallback-2026-06-01 unterstützt nur die Liste. Andere datierte Versionen werden abgelehnt.

Eine explizite Liste enthält höchstens drei Einträge mit unterschiedlichen Modellen. Keines darf dem angefragten Modell entsprechen. Die zulässigen Zielmodelle stammen aus allowed_fallback_models der Beta Models API. Pro Eintrag sind nur model, max_tokens, thinking, output_config und speed erlaubt. Überschreibungen müssen für das jeweilige Zielmodell gültig sein. Bei einem entsprechenden Fallback wandelt die Juli-Beta Sonnet 5.5 between_tools in Sonnet 5 disabled um und lässt display weg. Bei der Juni-Beta müssen Sie die Überschreibung der Denkeinstellung für Sonnet 5 selbst angeben.

fallback_credit_token dient einem separaten Wiederholungsversuch nach einer Ablehnung. Ein String wählt die strikte Einlösung; ein Objekt ergänzt mode. Im Modus strict führt eine fehlgeschlagene Einlösung zur Ablehnung des Wiederholungsversuchs. Im Modus best_effort kann die Verarbeitung bei einem Fehler auf Token-Ebene zum normalen Preis fortgesetzt werden; dies wird in usage.fallback_credit erfasst. Fehlerhaft formatierte Token sowie die Kombination des Guthabens mit fallbacks schlagen weiterhin fehl. Für die Einlösung gelten außerdem die Anforderungen an Anfrage, Konto, Workspace, Plattform und das Fünf-Minuten-Zeitfenster aus dem offiziellen Leitfaden zum Fallback-Guthaben.

Eine unbedenkliche Anfrage mit fallbacks: "default", dem Juli-Beta-Header und speed: "standard" lieferte den erwarteten Text. Dies bestätigt nur die Annahme der Anfrage: Fallback-Ausführung und Guthabeneinlösung wurden hier nicht durchgängig von Anfang bis Ende geprüft.

Medien- und Tool-Eingaben

Bilder verwenden image-Blöcke und PDFs document-Blöcke in einer Benutzernachricht. Zu den offiziellen Quelltypen gehören öffentliche URLs und base64 mit dem jeweiligen MIME-Typ. Die Kompatibilitätsprüfungen verwendeten ein base64-PNG und ein einseitiges base64-PDF und überprüften den Inhalt der Antworten. Nicht jede URL sowie nicht alle Grenzen für Dateigröße, Bildauflösung und PDF-Seitenzahl wurden getestet.

Clientseitige Tools verwenden den standardmäßigen Austausch tool_use → tool_result. Lassen Sie die Tool-Aufruf-IDs unverändert und geben Sie das Ergebnis in einer Benutzernachricht zurück. Ein erfolgreiches Beispiel mit einem Tool im strikten Modus bestätigt die Argumente dieses Beispiels, nicht jedes unterstützte JSON-Schema-Schlüsselwort.

Antworten

Eine Antwort ohne Streaming enthält id, type: "message", role: "assistant", model, content, stop_reason, stop_sequence und usage sowie optionale offizielle Felder wie container, diagnostics, context_management, stop_details und Beta-Antwortfelder. Der Inhalt kann Text, Denkblöcke, Tool-Aufrufe, Tool-Ergebnisse oder andere offizielle Blocktypen enthalten. Gehen Sie nicht davon aus, dass der erste Block Text enthält.

Verarbeiten Sie beim Streaming message_start, content_block_start, content_block_delta, content_block_stop, message_delta und message_stop. Auch innerhalb eines Streams können Fehler auftreten. Die Nutzungsdaten können reguläre Eingabe-/Ausgabetoken, Details zu Denk-Token, Cache-Lesezugriffe sowie getrennte Token-Zahlen für Cache-Schreibvorgänge mit 5 Minuten / 1 Stunde Gültigkeit enthalten.

Eine offizielle Ablehnung durch den Klassifikator ist eine normale Antwort mit stop_reason: "refusal" und stop_details, kein HTTP-Fehler. In einer Fallback-Antwort bezeichnet model das Modell, das geantwortet hat. fallback-Inhaltsblöcke kennzeichnen die Übergänge, und usage.iterations beschreibt die Versuche. Prüfen Sie diese Felder, statt anzunehmen, dass das angefragte Modell die Antwort geliefert hat. Dieses Antwortverhalten wurde hier noch nicht überprüft.

Messages-Fehler verwenden {"type":"error","error":{"type":"...","message":"..."}}. Fehlgeschlagene Anfragen werden nicht berechnet.

Kompatibilitätsprüfung: 2026-10-01

Beta-Tool-Ausführung, echte MCP-Verbindungen, Files-API-Referenzen, geografische Datenresidenz, erneutes Senden von Denksignaturen, die vollständigen Kontext-/Ausgabegrenzen, Mediengrenzfälle und Ablehnungs-/Fallback-Verhalten wurden nicht durchgängig von Anfang bis Ende validiert. HTTP 200 und ein zurückgegebener Modellname bestätigen weder die Identität des ausgeführten Modells noch, dass alle übergebenen Optionen wirksam wurden.

Referenzen

• Offizielle Übersicht zu Sonnet 5.5
• Änderungen und Einschränkungen von Sonnet 5.5
• Messages-Parameterreferenz
• Denkaufwand pro Nachricht
• Komprimierung auf Abruf
• Ablehnungen und Fallback
• Fallback-Guthaben
• OpenAPI-Schema
• Kopierbares Markdown