Anleitung: Claude Sonnet 5.5 API nutzen – Erster Aufruf, Aufwand, Überlegungen, Tools und Streaming

Um die Claude Sonnet 5.5 API zu verwenden, senden Sie eine POST-Anfrage an https://api.anthropic.com/v1/messages mit "model": "claude-sonnet-5-5", Ihrem Schlüssel im x-api-key-Header und anthropic-version: 2023-06-01. Sie kostet 2 $ pro Million Eingabe-Tokens und 10 $ pro Million Ausgabe-Tokens, liest bis zu 1 Mio. Tokens Kontext, schreibt bis zu 128K, führt standardmäßig adaptives Denken aus und ist standardmäßig auf high-Aufwand eingestellt.

Anthropic hat Sonnet 5.5 am 28. September 2026 veröffentlicht (was ist Claude Sonnet 5.5 behandelt Spezifikationen und Benchmarks). Dieser Leitfaden führt Sie durch einen ersten Aufruf in curl, Python und TypeScript, dann Aufwand, Denkprozesse, Tools, Streaming, Ablehnungen und Ratenbegrenzungen. Verschieben Sie Sonnet 5-Code? Der Leitfaden Sonnet 5.5 vs Sonnet 5 enthält jede bahnbrechende Änderung mit Vorher/Nachher-JSON. Sie können jede der untenstehenden Anfragen von Apidog senden und als gespeicherten Test mit Assertionen behalten.

Claude Sonnet 5.5 API auf einen Blick

Quellen: die Sonnet 5.5 Modellseite und der Migrationsleitfaden.

Claude Sonnet 5.5 API Beispiel: Ihr erster Aufruf

Erstellen Sie einen Schlüssel (der Anthropic API-Schlüssel-Leitfaden erklärt dies) und exportieren Sie ihn als ANTHROPIC_API_KEY, anstatt ihn fest zu codieren. Senden Sie dann Folgendes:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "output_config": {"effort": "medium"},
    "messages": [{"role": "user", "content": "Explain idempotency keys in two sentences."}]
  }'

Das Python SDK liest ANTHROPIC_API_KEY aus der Umgebung:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Explain idempotency keys in two sentences."}],
)
print(response.stop_reason)
for block in response.content:
    if block.type == "text":
        print(block.text)

TypeScript funktioniert auf die gleiche Weise:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();
const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  output_config: { effort: "medium" },
  messages: [{ role: "user", content: "Explain idempotency keys in two sentences." }],
});
for (const block of response.content) {
  if (block.type === "text") console.log(block.text);
}

Lesen Sie Inhaltsblöcke nach type. Das Denken ist standardmäßig aktiviert, sodass eine Antwort mit einem thinking-Block beginnen kann und Code, der content[0].text liest, fehlschlägt. Denk-Tokens werden als Ausgabe abgerechnet und zählen zu max_tokens, selbst wenn ihr Text ausgeblendet ist, lassen Sie also Spielraum über der erwarteten Antwort.

Wählen Sie ein Aufwandsniveau

Der Aufwand, festgelegt in output_config.effort, ist Ihr Hauptregler für Kosten und Qualität. Anthropic hat die Niveaus für Sonnet 5.5 neu kalibriert, sodass eine Sonnet 5-Einstellung nicht übernommen wird; führen Sie eine neue Überprüfung Ihrer eigenen Bewertungen durch. Der Prompting-Leitfaden schlägt diese Ausgangspunkte vor:

Die Spanne ist groß. Bei Anthropic's eigenen Terminal-Bench 4.0-Läufen erzielte Sonnet 5.5 bei high 43,0 % für 1,94 $ pro Versuch und bei max 70,6 % für 12,54 $. Die Sonnet 5.5 Preisaufschlüsselung erklärt die Kosten pro Anfrage.

Planen Sie drei Verhaltensweisen ein. Ab medium denkt das Modell vor fast jeder Antwort, selbst einer Begrüßung, und es ist nicht zuverlässig, es zu bitten, weniger zu denken: Verringern Sie stattdessen den Aufwand. Bei low und medium neigt es dazu, bei langen agentischen Aufgaben frühzeitig nachzufragen. Und das Ändern des übergeordneten Aufwands zwischen Anfragen macht den Prompt-Cache ungültig. Um mitten im Gespräch die Ebenen zu wechseln und den Cache beizubehalten, verwenden Sie den Aufwand pro Nachricht (Beta, Header anthropic-beta: mid-conversation-output-config-2026-07-01): Fügen Sie eine role: "system"-Nachricht mit leerem content und dem neuen output_config.effort hinzu.

Denken steuern: adaptiv oder zwischen Tools

Lassen Sie das thinking-Feld weg, und Sonnet 5.5 führt adaptives Denken aus. Es lehnt {"type": "disabled"} mit einem 400er-Fehler ab. Um das vorausschauende Denken auszuschalten, senden Sie between_tools, die niedrigste Einstellung:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 16000,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "high"},
  "messages": [{"role": "user", "content": "..."}]
}

Regeln für Sonnet 5.5 between_tools:

• Es funktioniert nur bei low, medium oder high. Bei xhigh oder max gibt es 400 zurück.
• Es akzeptiert keine anderen Felder. Das Hinzufügen von display, budget_tokens oder block_binding gibt 400 zurück.
• Es benötigt keinen Beta-Header und funktioniert auf jeder Plattform.
• Der Aufwand kann während der Einstellung nicht mitten im Gespräch geändert werden.
• SDK-Versionen, die es nicht definieren, schlagen bei der Typüberprüfung fehl, aktualisieren Sie also Ihr SDK.

Beim adaptiven Denken entscheidet display, was die Denkblöcke enthalten. Der Standardwert omitted gibt jeden thinking-Block mit einem leeren thinking-Feld plus einer signature zurück. summarized gibt lesbare Zusammenfassungen zurück. updates (Beta, Header thinking-display-updates-2026-08-18) gibt nur Fortschrittsaktualisierungen als Text zurück.

Fortschrittsaktualisierungen sind die Änderung, die eine Benutzeroberfläche am ehesten verwirren kann. Sonnet 5.5 platziert Notizen, die länger als ein oder zwei Sätze sind und zwischen Tool-Aufrufen geschrieben wurden, in eigene thinking-Blöcke anstelle von text. Unter dem Standardwert omitted sind diese Blöcke leer, sodass eine Agenten-Oberfläche, die zuvor ihre Schritte erzählte, still wird. Setzen Sie display: "updates" oder "summarized", oder verwenden Sie between_tools, das die Notizen mit Text zurückgibt. Rendern Sie jeden nicht leeren thinking-Block vor dem darauf folgenden tool_use-Block. Das Anfordern einer Begründung im Antworttext führt zu einer reasoning_extraction-Ablehnung, lesen Sie stattdessen diese Blöcke.

Tools ohne erzwungene Tool-Auswahl verwenden

Die erzwungene Tool-Nutzung ist weg. Eine tool_choice von {"type": "any"} oder {"type": "tool", ...} gibt einen 400er-Fehler mit dieser Meldung zurück, auch am Token-Zähl-Endpunkt:

tool_choice: type "tool" and "any" are not supported for this model.

Senden Sie auto, markieren Sie das Tool mit strict: true, damit seine Eingabe dem Schema entspricht, und teilen Sie dem Modell im Prompt mit, wann es aufgerufen werden soll:

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "tools": [{
    "name": "get_weather",
    "description": "Get the current weather for a city",
    "input_schema": {
      "type": "object",
      "properties": {"location": {"type": "string"}},
      "required": ["location"],
      "additionalProperties": false
    },
    "strict": true
  }],
  "tool_choice": {"type": "auto"},
  "messages": [{"role": "user", "content": "What's the weather in Paris? Use the get_weather tool."}]
}

Eine Anfrage kann höchstens 20 strikte Tools enthalten, und strikte Schemata benötigen additionalProperties: false bei jedem Objekt. Auf Amazon Bedrock sind strikte Tools für Sonnet 5.5 nicht verfügbar: Senden Sie auto ohne strict und validieren Sie die Eingabe in Ihrem Code.

Zwei Schleifendetails sind wichtig. Geben Sie jeden thinking-Block unverändert mit seinem tool_use-Block zurück, auch leere Blöcke. Und erwarten Sie gelegentliche Groß-/Kleinschreibungsfehler, wie z. B. bash für ein als Bash deklariertes Tool. Der Prompting-Leitfaden schlägt vor, eindeutige Übereinstimmungen zu akzeptieren oder ein tool_result mit is_error: true zurückzugeben, das den genauen Namen angibt.

Antworten streamen

Fügen Sie "stream": true zum Body hinzu oder verwenden Sie den Stream-Helfer des SDK. Für agentisches Coding empfiehlt der Prompting-Leitfaden max_tokens von 128.000 mit Streaming:

with client.messages.stream(
    model="claude-sonnet-5-5",
    max_tokens=128000,
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Review this diff for bugs: ..."}],
) as stream:
    for event in stream:
        if event.type == "content_block_delta" and event.delta.type == "text_delta":
            print(event.delta.text, end="", flush=True)
    final = stream.get_final_message()

Server-Sent Events kommen als message_start an, dann content_block_start, content_block_delta und content_block_stop für jeden Block, dann message_delta (mit stop_reason) und message_stop. Unter omitted streamt ein Denkblock einen leeren thinking_delta und einen signature_delta, dann beginnt der Text. Erwarten Sie eine Pause von mehreren Sekunden, bevor sich ein Fortschritts-Update-Block öffnet.

stream.get_final_message() (TypeScript: stream.finalMessage()) rekonstruiert vollständige Blöcke mit ihren Signaturen. Fügen Sie diesen Inhalt unverändert als Assistenten-Zug zum Verlauf hinzu und halten Sie den Verlauf nur anfügend. Sonnet 5.5 signiert jeden Denkblock über das vorhergehende Gespräch, sodass bei Konten, die am oder nach dem 31. August 2026 (00:00 UTC) erstellt wurden, das erneute Abspielen eines Blocks nach dem Bearbeiten des früheren Verlaufs 400 zurückgibt. Blöcke sind auch an das Konto gebunden, das sie erstellt hat.

Ablehnungen und Fallbacks behandeln

Eine Ablehnung ist kein Fehler. Sie erhalten HTTP 200 mit stop_reason: "refusal" und einem stop_details-Objekt, dessen category entweder cyber, bio, frontier_llm, reasoning_extraction oder general_harms ist, plus einer explanation. Zeigen Sie die Erklärung an, anstatt sie zu parsen; ihre Formulierung ist nicht stabil. Verzweigen Sie anhand von stop_reason, bevor Sie content lesen.

Server-seitiger Fallback ist optional. Fügen Sie "fallbacks": "default" und den anthropic-beta: server-side-fallback-2026-07-01-Header hinzu (Beta, nur Claude API), und die API wiederholt cyber- und frontier_llm-Ablehnungen bei Sonnet 5. Die anderen drei Kategorien werden nicht wiederholt. Das model-Feld der Antwort benennt das Modell, das sie bereitgestellt hat, und ein fallback-Inhaltsblock kennzeichnet die Übergabe.

Ratenbegrenzungen

Sonnet 5.5 hat seine eigene Ratenbegrenzung, getrennt von der von Sonnet 5. Die Seite zu den Ratenbegrenzungen listet vier Stufen auf:

Für die Behandlung von 429er-Fehlern und Backoff siehe den Leitfaden für überschrittene Ratenbegrenzungen.

Testen Sie die Claude Sonnet 5.5 API in Apidog

Gespeicherte Anfragen machen Aufwandsvergleiche und Stream-Debugging wiederholbar. So richten Sie es in Apidog ein:

1. Erstellen Sie eine Umgebung und fügen Sie ANTHROPIC_API_KEY als Variable hinzu. Referenzieren Sie sie als {{ANTHROPIC_API_KEY}} im x-api-key-Header, neben anthropic-version und content-type.
2. Erstellen Sie eine POST-Anfrage an https://api.anthropic.com/v1/messages, fügen Sie den Body des ersten Aufrufs ein und speichern Sie sie.
3. Fügen Sie Assertionen hinzu: Status ist 200, $.stop_reason gleich end_turn, $.usage.output_tokens ist größer als 0, und $.content[*].type enthält text. Eine Ablehnung lässt den Test nun fehlschlagen, anstatt stillschweigend zu bestehen.
4. Duplizieren Sie die Anfrage mit "stream": true. Apidog zeigt die text/event-stream-Antwort Ereignis für Ereignis an, sodass Sie sehen können, wie der leere thinking_delta, der signature_delta und der Text der Reihe nach eintreffen.
5. Klonen Sie sie erneut mit "model": "claude-sonnet-5" und bewahren Sie das Paar in einem Ordner auf: gleicher Prompt, zwei Modelle, usage nebeneinander.

Für umfassendere Muster siehe Testen von LLM-Anwendungen und Testen von AI-Agent-APIs.

FAQ

Was ist die Modell-ID von Claude Sonnet 5.5? claude-sonnet-5-5, ohne Datums-Suffix, auf der Claude API, Google Cloud, Microsoft Foundry und Claude Platform auf AWS. Auf Amazon Bedrock ist es anthropic.claude-sonnet-5-5.

Kann ich das Denken komplett ausschalten? Nein. disabled gibt 400 zurück. between_tools ist die niedrigste Einstellung: kein vorausschauendes Denken, bei low, medium oder high Aufwand.

Warum gibt meine Sonnet 5-Anfrage bei Sonnet 5.5 einen 400er-Fehler zurück? Überprüfen Sie zuerst auf thinking.type: "disabled" und eine erzwungene tool_choice. Der Leitfaden Sonnet 5.5 vs Sonnet 5 behandelt alle fünf bahnbrechenden Änderungen und deren Behebungen.

Gibt es eine kostenlose Claude Sonnet 5.5 API? Die API von Anthropic ist Prepaid, und keine offizielle Seite listet einen kostenlosen Anmelde-Guthaben auf. Ein Claude Chat-Plan beinhaltet ebenfalls keinen API-Zugriff. Der Leitfaden zur kostenlosen API behandelt Kreditprogramme und den günstigsten kostenpflichtigen Weg.

Nächster Schritt

Senden Sie die erste Anfrage mit medium, führen Sie sie dann mit high erneut aus und vergleichen Sie usage.output_tokens und die Antwortqualität anhand eines Prompts aus Ihrer eigenen Arbeitslast. Laden Sie Apidog herunter, um beide Durchläufe mit Assertionen zu speichern. Wenn Sie lieber vom Terminal aus arbeiten möchten, siehe Claude Sonnet 5.5 in Claude Code.