Claude Sonnet 5.5 API
Claude Sonnet 5.5 API: adaptives Thinking oder between_tools, Parametergrenzen, Streaming und aktuelle Token- und Cache-Preise nach Gruppe.
Diese Referenz beschreibt Claude Sonnet 5.5 und die modellspezifischen Messages-Parameter. Verwende claude-sonnet-5-5 mit POST https://api.wanapi.app/v1/messages. Claude-Modelle vergleichen.
Modelleinstellungen
| Einstellung | Claude Sonnet 5.5 |
|---|---|
| Modell-ID | claude-sonnet-5-5 |
| Kontextfenster | 1M Tokens |
| Maximale synchrone Ausgabe | 128000 Tokens einschließlich Thinking |
| Thinking-Modi | Adaptiv oder between_tools |
| Standardwert für effort | high |
Erzwungene Tool-Aufrufe (any / tool) | Nicht unterstützt |
Verbindung einrichten und Anfrage senden
Erstelle in den Einstellungen für API-Schlüssel einen Schlüssel. Ein API-Schlüssel funktioniert für alle Modelle und Gruppen. Speichere ihn in deiner Serverumgebung als WAN_API_KEY. Sende anthropic-version: 2023-06-01; ergänze anthropic-beta nur für Funktionen, die diesen Header erfordern.
curl https://api.wanapi.app/v1/messages \
-H "x-api-key: $WAN_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 the purpose of a database index in three sentences."}]
}'import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["WAN_API_KEY"],
base_url="https://api.wanapi.app",
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))Aktuell unterstützte API-Funktionen
Die folgende Tabelle beschreibt die native Schnittstelle dieses Modells. Wan API leitet Anfragen derzeit über eine Kompatibilitätsschicht weiter. Verwende einen positiven Wert für max_tokens: Das Gateway ersetzt 0 derzeit durch ein Generierungsbudget. Dieser Wert lässt sich hier daher nicht zum ausschließlichen Vorbefüllen des Caches nutzen.
Das aktuelle Gateway leitet diagnostics, compaction, fallbacks, fallback_credit_token und thread nicht weiter. Die aktuelle Kanalkonfiguration filtert außerdem speed, service_tier und inference_geo. Diese Felder sind unten zur Erläuterung der Modellschnittstelle dokumentiert, stehen über diese Anbindung aber noch nicht zur Verfügung. Eine erfolgreiche Antwort bedeutet nicht, dass ein ignoriertes Feld wirksam war. Für Beta-Funktionen, die diese Felder benötigen, gilt dieselbe Einschränkung.
Parameter
| Parameter | Typ / erforderlich | Offizielle Einschränkungen und Standardwerte |
|---|---|---|
model | string, erforderlich | claude-sonnet-5-5. |
max_tokens | integer, erforderlich | 0–128000 einschließlich Thinking-Tokens. Laut offizieller Schnittstelle befüllt 0 den Prompt-Cache, ohne Ausgabe zu erzeugen; siehe „Aktuell unterstützte API-Funktionen“. |
messages | Objektarray, erforderlich | Mindestens eine Gesprächsnachricht, höchstens 100000. Jede enthält role und content; der Inhalt ist eine Zeichenfolge oder ein Array von Inhaltsblöcken. Normale Beiträge verwenden user/assistant. Für system-Nachrichten innerhalb eines Gesprächs gelten die offiziellen Platzierungsregeln. |
system | Zeichenfolge oder Array von Textblöcken | Anweisungen auf oberster Ebene. Textblöcke können Cache-Breakpoints enthalten. |
thinking | object | Standard: {"type":"adaptive"}. Der andere unterstützte Modus ist {"type":"between_tools"}. Manuelle Budgets und disabled werden abgelehnt. |
thinking.display | enum | Nur im adaptiven Modus: omitted (Standard) oder summarized. Eine ausgelassene Zusammenfassung bedeutet nicht, dass Thinking deaktiviert ist. |
thinking.block_binding | object, Beta | Nur im adaptiven Modus. Erfordert thinking-binding-controls-2026-08-01; beachte die offiziellen Vorgaben zum Beibehalten von Thinking. |
output_config.effort | enum oder null | low, medium, high, xhigh, max; Standard high. Null belässt den Standardwert. |
output_config.format | object oder null | Strukturierte JSON-Ausgabe: {"type":"json_schema","schema":{...}}. Verwende die unterstützte Teilmenge von JSON Schema. |
stream | boolean | Standard false; true gibt SSE-Ereignisse zurück. |
stop_sequences | Zeichenfolgenarray | Stoppt laut offizieller Schnittstelle die Generierung bei einer passenden Zeichenfolge. Die Kompatibilitätsprüfung beim vorgelagerten Dienst setzte dieses Verhalten nicht durch. |
temperature | number oder null | Aus Kompatibilitätsgründen wird nur 1 akzeptiert; weglassen. Andere Werte außer null werden abgelehnt. |
top_p | number oder null | Aus Kompatibilitätsgründen wird nur 0.99–1 akzeptiert; weglassen. |
top_k | kein Wert außer null | Sampling wird nicht unterstützt; lass diese Eigenschaft weg. |
tools | Objektarray | Client-Tools enthalten name, input_schema und optionale Beschreibungs- bzw. Striktheitseinstellungen. Server-Tools verwenden ihre versionierten offiziellen Definitionen. |
tool_choice | object | auto (Standard) oder none. any und ein benanntes erzwungenes tool werden abgelehnt. auto darf disable_parallel_tool_use enthalten. |
metadata.user_id | string oder null | Höchstens 512 Zeichen; verwende eine nicht sprechende Kennung. |
cache_control | object oder null | type: "ephemeral"; ttl: "5m" (Standard) oder "1h". Sonnet 5.5 benötigt mindestens 512 cachefähige Tokens. Die offizielle API unterstützt auch Cache-Breakpoints auf Blockebene. |
diagnostics | object oder null | previous_message_id: Zeichenfolge mit höchstens 256 Zeichen oder null. Fordert eine Diagnose von Cache-Abweichungen an. |
service_tier | enum | auto (Standard) oder standard_only. |
speed | enum oder null | Weglassen oder standard / null verwenden. Sonnet 5.5 unterstützt fast nicht. |
inference_geo | string oder null | Der offizielle Standard stammt aus den Kontoeinstellungen. Eine angenommene Anfrage allein bestätigt nicht die geografische Verarbeitung. |
fallbacks | string, Objektarray oder null, Beta | "default" oder bis zu drei Fallback-Einträge. Jeder erfordert model; optionale Überschreibungen sind max_tokens, thinking, output_config und speed. Siehe die Fallback-Regeln unten. |
fallback_credit_token | string, object oder null | Ein Token aus einer vorherigen Ablehnung oder {"token":"...","mode":"strict"}. Die Objektform erfordert fallback-credit-2026-07-01; mode ist strict (Standard) oder best_effort. Darf nicht zusammen mit einem von null abweichenden fallbacks-Wert verwendet werden. |
container | string, object oder null | Container-ID oder Container-Konfiguration mit optionalem id und skills (höchstens 20). Skills verwenden die offiziellen Typ-, Kennungs- und Versionsfelder. |
context_management | object oder null | Offizielle Konfiguration für Kontextbearbeitungen einschließlich edits; null lässt die Einstellung weg. Die modellspezifische Kompatibilität der Bearbeitungen gilt weiterhin. |
mcp_servers | Objektarray | Offizielle MCP-Serverdefinitionen mit der erforderlichen Beta-Version und Serverauthentifizierung. Eine Prüfung mit leerem Array bestätigt keine entfernte MCP-Ausführung. |
compaction | object oder null, Beta | {"type":"summarize"} mit compact-2026-09-04; null lässt die Komprimierung weg. Aktivierte Komprimierung lässt sich nicht mit einem von null abweichenden context_management, Stoppsequenzen oder einem Format für strukturierte Ausgabe kombinieren. Das Verhalten signierter Komprimierung bestand den aktuellen Test nicht. |
messages[].output_config.effort | enum, Beta | Effort pro Nachricht in einer Systemnachricht; erfordert mid-conversation-output-config-2026-07-01. Systemnachrichten, die ausschließlich effort setzen, dürfen überall stehen; für Systemgruppen mit Inhalt gelten die offiziellen Platzierungsregeln. Im Modus between_tools darf effort dadurch nicht verändert werden. |
Thinking und Tools
between_tools akzeptiert nur die Eigenschaft type sowie effort low, medium oder high. Sende dabei weder display noch 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."}]
}Das Vorbefüllen einer Assistant-Antwort wird nicht unterstützt. Um einen pause_turn fortzusetzen, sende den zurückgegebenen Assistant-Inhalt des Server-Tools unverändert erneut. Komprimierung fasst den vorhandenen Verlauf zusammen und ist kein Vorbefüllen einer Assistant-Antwort. Bewahre Thinking-Blöcke und Signaturen exakt auf; verschiebe sie nicht zwischen Modellen und bearbeite den früheren Verlauf nicht, ohne die offiziellen Bindungsregeln zu beachten.
In der nativen Claude API erfordert Computer Use 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.
Medieneingaben
Verwende für Bilder und PDFs öffentlich zugängliche HTTP(S)-URLs in den content-Blöcken einer Nutzernachricht. Stelle deine Dateien selbst bereit; diese Anbindung bietet weder eine Files API noch Uploads. Beispiel für eine Bildeingabe:
{"role":"user","content":[
{"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
{"type":"text","text":"What does this chart show?"}
]}Verwende für eine PDF einen document-Block. Lass Tool-Use-IDs, vollständige Thinking-Blöcke und Signaturen beim Fortsetzen eines Gesprächs unverändert. Deine Anwendung führt Client-Tools aus und gibt ihre Ergebnisse zurück; die Deklaration eines Tools führt es noch nicht aus.
Preise
USD pro 1 Million Tokens
Die aktuellen Tarife enthalten den Multiplikator der jeweiligen Gruppe. Preise werden bis zu 2 Minuten zwischengespeichert.
Ein API-Schlüssel funktioniert für alle Modelle und Gruppen. Standard kennzeichnet die erste geeignete Gruppe in der automatischen Routing-Reihenfolge. Es gelten die Tarife der tatsächlich gewählten Gruppe.
Claude Sonnet 5.5
claude-sonnet-5-5
| Abrechenbare Tokens | claude · Standard |
|---|---|
| Alle Eingabelängen | |
| Eingabe (nicht gecacht) | 1 $ |
| Ausgabe | 5 $ |
| Cache-Lesezugriff | 0,05 $ |
| Cache-Schreibvorgang · 5 Minuten | 1,25 $ |
| Cache-Schreibvorgang · 1 Stunde | 2 $ |
— bedeutet, dass kein verifizierter Preis vorliegt; es bedeutet nicht kostenlos.
Cache-Tarife gelten nur, wenn die Antwort den entsprechenden Cache-Verbrauch ausweist. Zähle gecachte Tokens nicht erneut als nicht gecachte Eingabe.
Multipliziere jede abrechenbare Token-Zahl mit dem passenden Tarif und teile die Summe durch 1.000.000. Thinking-Tokens sind in den Ausgabe-Tokens enthalten und werden nicht erneut berechnet. Für Cache-Lesezugriffe sowie Schreibvorgänge mit 5 Minuten oder 1 Stunde Gültigkeit gelten separate Tarife. Wähle bei längenabhängigen Preisen vor der Kostenberechnung die zutreffende Preisstufe aus.
Antwort und Streaming
Eine abgeschlossene Nachricht enthält id, type, role, model, content, stop_reason und usage. Lies die Textblöcke aus content; der erste Block kann stattdessen Thinking oder einen Tool-Aufruf enthalten. Die folgende Antwort dient als Beispiel:
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5-5",
"content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 24, "output_tokens": 18}
}Setze für SSE stream: true und verwende curl -N. Verarbeite message_start, content_block_start, content_block_delta, content_block_stop, message_delta und message_stop sowie ping und Streaming-Fehler. Lies die abschließenden Verbrauchsdaten aus, statt jeden Abschnitt als vollständige Antwort zu behandeln.
OpenAI-kompatible Formate
Dieselbe Modell-ID funktioniert mit POST /v1/chat/completions und POST /v1/responses. Verwende Authorization: Bearer YOUR_API_KEY und die OpenAI-SDK-Basis-URL https://api.wanapi.app/v1. Chat Completions nutzt messages, Responses nutzt input. Ihre Felder werden in Messages umgewandelt. Verwende daher /v1/messages für die oben dokumentierten nativen Parameter.
curl https://api.wanapi.app/v1/chat/completions \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'Nutzungsprotokolle und Fehler
Die LLM-Protokolle zeigen abgeschlossene Aufrufe der letzten 7 Tage mit Modell, Eingabe-Tokens, Ausgabe-Tokens und Kosten. Aktualisiere die Ansicht nach einem Aufruf und filtere nach claude-sonnet-5-5. Verwende für Bilder und Videos die Aufgabenprotokolle.
Prüfe bei einer fehlgeschlagenen Anfrage den HTTP-Status und das error-Objekt. Prüfe den Schlüssel, den Kontostand, die Modell-ID und die unterstützten Parameterkombinationen. Eine Ablehnung oder ein Stopp am Ausgabelimit ist etwas anderes als ein HTTP-Fehler. Prüfe bei einer unterbrochenen Anfrage oder einem unterbrochenen Stream vor einem erneuten Versuch die Protokolle: Eine neue Anfrage kann weitere Kosten verursachen.
Modellreferenzen
Claude Haiku 5.5
Claude Haiku 5.5 API: adaptives oder deaktiviertes Thinking, erzwungene Tool-Aufrufe, Parameter, Streaming und aktuelle Token-Preise nach Gruppe.
Claude Opus 5.5
Claude Opus 5.5 API: adaptives Thinking mit effort medium als Standard, Anfrageparameter, Streaming und aktuelle Token-Preise nach Gruppe.