Leitfäden für Modelle und Modalitäten21. Oktober 2026Flatkey Team

Claude Sonnet API (2026): Modell-IDs, Einrichtung, Limits und Code für Sonnet 5.5

Alles, um Claude Sonnet 5.5 per API aufzurufen: Modell-IDs, Keys, lauffähiger Code, Effort und Thinking, Rate Limits, Kosten und Fixes für die Migration.

Claude Sonnet API (2026): Modell-IDs, Einrichtung, Limits und Code für Sonnet 5.5

Um die Claude Sonnet API zu nutzen, erstellen Sie einen Anthropic-API-Key und senden eine Anfrage an https://api.anthropic.com/v1/messages mit der Modell-ID claude-sonnet-5-5 – dem aktuellen Sonnet-Modell, veröffentlicht am 28. September 2026. Es bietet ein Kontextfenster von 1M Tokens, bis zu 128K Ausgabe-Tokens, standardmäßig aktiviertes adaptives Thinking und kostet laut offizieller Anthropic-Preisliste (Stand 21. Oktober 2026) 2 $ pro Million Eingabe-Tokens und 10 $ pro Million Ausgabe-Tokens. Wenn Sie Code von Sonnet 4.6 oder älter migrieren, liefern fünf früher funktionierende Parameter jetzt einen 400-Fehler; sie sind unten aufgeführt.

Dieser Leitfaden richtet sich an Entwickler, die ein Produkt auf Claude bauen: welche Sonnet-Modell-ID Sie aufrufen, wie Sie einen Key erhalten, lauffähiger Code in curl, Python und Node.js, Rate Limits nach Stufe und die Breaking Changes, an denen Migrationen am häufigsten scheitern. Eine vollständige Kostenaufstellung aller Claude-Modelle finden Sie in unserem Leitfaden zu den Claude-API-Preisen.

Über die API verfügbare Claude-Sonnet-Modelle

Modell	API-Modell-ID	Status (21. Okt. 2026)	Kontext / max. Ausgabe	Eingabe / Ausgabe pro 1M Tokens	Cache-Lesen
Claude Sonnet 5.5	`claude-sonnet-5-5`	Aktuell, veröffentlicht am 28. Sept. 2026	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	Legacy	siehe Modelldoku	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	Legacy	siehe Modelldoku	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Veraltet, Abschaltung am 30. Nov. 2026	siehe Modelldoku	$3 / $15	$0.30

Preise von der Anthropic-Preisseite; Modellstatus aus der Modellübersicht und der Seite zu Abkündigungen; Sonnet-5.5-Spezifikationen aus der Sonnet-5.5-Übersicht, alles geprüft am 21. Oktober 2026.

Welches Modell: Verwenden Sie für neue Projekte claude-sonnet-5-5. Laut Migrationsleitfaden kostet es pro Token genauso viel wie Sonnet 5, beim Cache-Lesen aber nur die Hälfte (0,10 $ statt 0,20 $ pro Million). Gegenüber Sonnet 4.6 (3 $ / 15 $) ist Sonnet 5.5 pro Token günstiger – achten Sie aber auf den Tokenizer: Laut Anthropic erzeugt Sonnet 5.5 für denselben Text etwa 30 % mehr Tokens als Sonnet 4.6. Vergleichen Sie daher reale Token-Mengen statt nur Listenpreise. Nutzer von Sonnet 4.5 müssen vor der Abschaltung am 30. November 2026 migrieren.

Sonnet 5.5 auf einen Blick

Merkmal	Wert	Quelle
Modell-ID (Claude API, Google Cloud, Microsoft Foundry, Claude Platform on AWS)	`claude-sonnet-5-5`	Übersicht
Modell-ID bei Amazon Bedrock	`anthropic.claude-sonnet-5-5`	Übersicht
Kontextfenster	1M Tokens	Übersicht
Maximale Ausgabe	128K Tokens; 300K in der Batch API mit dem Beta-Header `output-300k-2026-03-24`	Übersicht
Ein- / Ausgabemodalitäten	Text und Bilder rein, Text raus	Übersicht
Thinking	Adaptiv, standardmäßig an; niedrigste Stufe `between_tools`	Übersicht
Standard-Effort	`high`	Übersicht
Wissensstand	Juni 2026	Übersicht
Abschaltung	Nicht vor dem 28. September 2027	Übersicht

So erhalten Sie einen Claude-Sonnet-API-Key

Melden Sie sich in der Claude Console an und öffnen Sie API keys.
Erstellen Sie einen Key, kopieren Sie ihn einmalig und speichern Sie ihn als ANTHROPIC_API_KEY in Ihrer Umgebung oder Ihrem Secret Manager.
Laden Sie Guthaben auf oder hinterlegen Sie eine Zahlungsmethode. Die Nutzungsstufe (und damit die Rate Limits) steigt mit den Ausgaben; siehe den Abschnitt zu Rate Limits unten.

Ein Key funktioniert für alle Claude-Modelle, einen separaten „Sonnet-API-Key“ gibt es nicht. Wenn Sie lieber einen einzigen Key für Claude, GPT, Gemini und DeepSeek möchten, stellt eine einheitliche API wie Flatkey einen Key für alle aus (mehr dazu am Ende).

Ihre erste Anfrage an Claude Sonnet 5.5

Die folgende Anfrage folgt dem offiziellen Beispiel von Anthropic im Sonnet-5.5-Migrationsleitfaden. Sie setzt eine Effort-Stufe und vermeidet alle Parameter, die bei diesem Modell einen 400-Fehler liefern.

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,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

Python mit dem offiziellen anthropic-SDK:

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

Node.js mit @anthropic-ai/sdk:

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

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

Lesen Sie die Antwort nach Blocktyp aus. Bei aktivem adaptivem Thinking kann der erste Inhaltsblock ein thinking-Block sein; response.content[0].text ist auf Sonnet 5.5 daher nicht sicher.

Effort und Thinking bei Sonnet 5.5

Sonnet 5.5 ersetzt feste Thinking-Budgets durch eine effort-Einstellung in output_config (Effort-Doku). Der Standard ist high. Der Migrationsleitfaden von Anthropic zeigt die Stufen low, medium, high, xhigh und max.

Ziel	Senden	Hinweise aus der Anthropic-Doku
Standardverhalten	nichts oder `thinking: {"type": "adaptive"}`	Adaptives Thinking ist standardmäßig an
Günstigere, schnellere Antworten	`output_config: {"effort": "low"}` oder `"medium"`	Weniger Effort bedeutet weniger Ausgabe-Tokens
Kein vorgelagertes Thinking	`thinking: {"type": "between_tools"}`	Zulässig bei `low`, `medium`, `high`; 400-Fehler bei `xhigh` oder `max`
Schwierigste Aufgaben	`output_config: {"effort": "xhigh"}` oder `"max"`	Adaptives Thinking statt `between_tools` verwenden

thinking: {"type": "disabled"} wird von Sonnet 5.5 nicht akzeptiert; between_tools ist die niedrigste Einstellung (Migrationsleitfaden).

Parameter, die jetzt einen 400-Fehler liefern

Wenn Sie von Sonnet 4.6 oder älter upgraden, entfernen Sie diese Parameter. Alle fünf stehen im Sonnet-5.5-Migrationsleitfaden von Anthropic:

Alter Parameter	Bei Sonnet 5.5	Ersetzen durch
`thinking: {"type": "enabled", "budget_tokens": N}`	400-Fehler	`output_config.effort`
`temperature`, `top_p`, `top_k`	400-Fehler	Anweisungen im Prompt; Effort
Assistant-Prefill (letzte Nachricht von `assistant`)	400-Fehler	Strukturierte Ausgaben oder Systemanweisungen
Erzwungenes `tool_choice` (`any` oder ein benanntes Tool)	400-Fehler	`auto` plus klare Tool-Anweisungen
`thinking: {"type": "disabled"}`	400-Fehler	`thinking: {"type": "between_tools"}`

Prüfen Sie wegen der rund 30 % mehr Tokens gegenüber Sonnet 4.6 auch max_tokens und Ihre Kostenschätzungen. Wenn nach dem Upgrade Modell-ID-Fehler auftreten, behandeln unsere Leitfäden Claude: Modellversion nicht gefunden und Anthropic-400-Fehler die häufigsten Ursachen.

Rate Limits der Claude Sonnet API

Anthropic veröffentlicht die Limits pro Stufe auf der Rate-Limit-Seite. Für Sonnet 5.5, Stand 21. Oktober 2026:

Stufe	Anfragen pro Minute	Eingabe-Tokens pro Minute	Ausgabe-Tokens pro Minute
Start	1.000	2.000.000	400.000
Build	5.000	5.000.000	1.000.000
Scale	10.000	10.000.000	2.000.000

Sonnet 5, Sonnet 4.x und Haiku 5.5 haben pro Stufe dieselben Werte. Anthropic weist darauf hin, dass aus dem Cache gelesene Eingabe-Tokens bei den meisten Modellen nicht auf das Limit für Eingabe-Tokens pro Minute angerechnet werden. Prompt Caching ist damit sowohl ein Kosten- als auch ein Rate-Limit-Werkzeug.

Was Sonnet 5.5 in der Praxis kostet

Offizielle Preise am 21. Oktober 2026 pro 1M Tokens (Preise):

Posten	Preis
Eingabe	$2.00
Ausgabe	$10.00
Cache-Schreiben, 5 Minuten	$2.50
Cache-Schreiben, 1 Stunde	$4.00
Cache-Lesen	$0.10
Batch API Eingabe / Ausgabe	$1.00 / $5.00
Inferenz nur in den USA (`inference_geo`)	1,1-fach auf alle Token-Preise

Rechenbeispiel: Ein Support-Assistent bearbeitet 50.000 Anfragen pro Monat, jeweils mit einem gecachten System-Prompt von 3.000 Tokens, 500 neuen Eingabe-Tokens und 400 Ausgabe-Tokens. Cache-Lesen: 150M Tokens × 0,10 $ = 15 $. Neue Eingabe: 25M × 2 $ = 50 $. Ausgabe: 20M × 10 $ = 200 $. Zusammen etwa 265 $ pro Monat, ohne einmalige Cache-Schreibvorgänge. Die Ausgabe dominiert – deshalb bringt effort mehr als die Optimierung der Eingabe. Vergleiche Modell für Modell finden Sie unter Claude-API-Preise und API-Routing Claude vs. GPT.

Claude Sonnet mit dem OpenAI SDK nutzen

Anthropic bietet unter https://api.anthropic.com/v1/ einen OpenAI-kompatiblen Endpunkt an, doch die Seite zur OpenAI-SDK-Kompatibilität beschreibt ihn als Werkzeug für Tests und Vergleiche, nicht für die meisten Produktiveinsätze: Der strict-Parameter beim Function Calling wird ignoriert, response_format wird ignoriert, und Prompt Caching wird nicht unterstützt. Für den Produktivbetrieb mit Sonnet 5.5 verwenden Sie die oben gezeigte native Messages API. Unser Beitrag zur Kompatibilität der Claude API mit dem OpenAI SDK erläutert die Optionen im Detail.

Ein Key für Sonnet und weitere Modelle: Flatkey

Wenn Ihr Produkt auch GPT, Gemini oder DeepSeek aufruft, erhalten Sie bei Flatkey einen Key und ein Prepaid-Guthaben für alle. Am 21. Oktober 2026 nannte Flatkeys Modellseite zu Claude Sonnet 5.5 1,60 $ Eingabe / 8,00 $ Ausgabe pro 1M Tokens – 20 % unter Anthropics 2 $ / 10 $ – und Sonnet 4.6 mit 2,40 $ / 12,00 $. Das Anthropic-SDK funktioniert, indem Sie die Base-URL auf https://router.flatkey.ai (ohne /v1) ändern, so Flatkeys Anleitung zum Anthropic SDK:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Für Claude Code siehe API-Router-Einrichtung für Claude Code. Nutzen Sie Anthropic direkt, wenn Sie Funktionen oder Verträge brauchen, die es nur auf der eigenen Plattform gibt, etwa bestimmte Beta-Header am Veröffentlichungstag oder einen Enterprise-Vertrag.

FAQ

Wie heißt das Modell in der Claude Sonnet API?

Die aktuelle Modell-ID lautet claude-sonnet-5-5 in der Claude API, bei Google Cloud, Microsoft Foundry und Claude Platform on AWS sowie anthropic.claude-sonnet-5-5 bei Amazon Bedrock (Stand 21. Oktober 2026). Ältere IDs sind unter anderem claude-sonnet-5 und claude-sonnet-4-6.

Was kostet die Claude Sonnet API?

Claude Sonnet 5.5 kostet 2 $ pro Million Eingabe-Tokens und 10 $ pro Million Ausgabe-Tokens; Cache-Lesen kostet 0,10 $, die Batch API den halben Preis (1 $ / 5 $), laut Anthropic-Preisseite, geprüft am 21. Oktober 2026.

Ist die Claude Sonnet API kostenlos?

Nein. Die Anthropic-API wird pro Token abgerechnet; eine kostenlose API-Stufe für Sonnet gibt es nicht. Die Claude-Apps für Endnutzer haben eigene kostenlose und kostenpflichtige Tarife, die von der API-Abrechnung getrennt sind. Kostenlose Optionen anderer Anbieter finden Sie in unserem Leitfaden zu kostenlosen LLM-APIs.

Wie groß ist das Kontextfenster von Claude Sonnet 5.5?

1M Tokens, mit bis zu 128K Ausgabe-Tokens pro Anfrage oder 300K in der Message Batches API mit dem Beta-Header output-300k-2026-03-24.

Warum liefert meine Sonnet-Anfrage nach dem Upgrade einen 400-Fehler?

Sonnet 5.5 lehnt Thinking-Budgets, temperature/top_p/top_k, Assistant-Prefill, erzwungene Tool-Auswahl und thinking: {"type": "disabled"} ab. Entfernen Sie diese und verwenden Sie stattdessen output_config.effort oder thinking: {"type": "between_tools"}.

Gibt es eine Claude Sonnet 5 API?

Ja. claude-sonnet-5 ist als Legacy-Modell weiterhin aufrufbar, für 2 $ / 10 $ pro Million Tokens, Cache-Lesen 0,20 $. Sonnet 5.5 hat dieselben Token-Preise bei halb so teurem Cache-Lesen und ist damit die bessere Standardwahl für neue Projekte.