Claude API 2026-10-21 streicht temperature, top_p und top_k

Anthropic hat am 21. Oktober 2026 eine neue Version der Claude API veröffentlicht: 2026-10-21. Sie entfernt die Sampling-Einstellungen temperature, top_p und top_k. Jede Anfrage, die eine davon sendet, scheitert jetzt mit einem 400-Fehler. Sieben offizielle SDKs und das Kommandozeilenwerkzeug ant haben neue Hauptversionen veröffentlicht, die standardmäßig diese Version nutzen.

Die bisherige Version, 2023-06-01, war mehr als drei Jahre lang der Standard. Der tägliche Agent-Tools-Überblick von Munder Difflin beschreibt dies als Anthropics erste neue API-Version seit damals.

Wie Versionen der Claude API funktionieren

Jede Anfrage an die Claude API trägt einen Header anthropic-version. Sein Wert ist ein Datum, das die Anfrage an ein festes Verhalten bindet. Wer die neue Version ohne SDK nutzen will, sendet anthropic-version: 2026-10-21.

Innerhalb einer Version verspricht Anthropics Seite zur Versionierung, dass bestehende Eingabe- und Ausgabefelder unverändert bleiben. Anthropic kann trotzdem optionale Eingaben, neue Ausgabewerte und neue Typen von Streaming-Ereignissen hinzufügen. Wer ein Feld entfernen oder umbenennen will, braucht eine neue datierte Version, und genau das ist hier passiert.

Die SDKs wählen die Version für Sie. Laut dem Migrationsleitfaden „nutzen Anfragen die API-Version, die aktuell war, als die Hauptversion Ihres SDK veröffentlicht wurde“. Code auf einer älteren SDK-Hauptversion sendet weiter 2023-06-01, bis Sie das SDK aktualisieren.

Was in der Messages API nicht mehr funktioniert

Drei Arten von Anfragen liefern jetzt einen 400-Fehler, so Anthropics Release Notes:

• Sampling-Einstellungen. temperature, top_p und top_k wurden entfernt. Wer eine davon sendet, scheitert bei jedem Modell.
• Dokumente in Assistant-Turns. Ein document-Block, der direkt in einer assistant-Nachricht steht, wird abgelehnt.
• Zitate in User-Turns. Ein text-Block mit einem nicht leeren citations-Array in einer user-Nachricht wird abgelehnt. Das gilt auch für einen solchen Block, der in einem search_result-Block verschachtelt ist.

Die Admin API benennt außerdem mehrere Felder um. RBAC-Gruppen nutzen role_ids statt roles, und Rollen nutzen display_name statt name. Bei API-Schlüsseln wandert workspace_id nach scope.workspace_id. Auch zwei Felder von Claude Enterprise Analytics ändern sich: Aus actor.email wird actor.email_address, und aus summaries wird data.

Die neue Version funktioniert auf der Claude API, Claude Platform on AWS, Microsoft Foundry und Google Cloud. Auf Amazon Bedrock gilt sie nur für Claude 4.7 und neuere Modelle.

Die neuen SDK-Hauptversionen

Dies sind laut Release Notes und Migrationsleitfaden die ersten Releases, die 2026-10-21 senden:

SDK oder Tool	Erste Version mit 2026-10-21
Python (anthropic)	2.0.0
TypeScript (@anthropic-ai/sdk)	1.0.0
C# (Anthropic)	13.0.0
Go (anthropic-sdk-go/v2)	2.0.0
Java (com.anthropic:anthropic-java)	3.0.0
PHP (anthropic-ai/sdk)	1.0.0
Ruby (Gem anthropic)	2.0.0
ant CLI	2.0.0

Die SDKs bringen eigene inkompatible Änderungen mit, unabhängig von der API-Version. Der Migrationsleitfaden nennt die wichtigsten:

• Authorization-Header. Die SDKs und die CLI senden den Schlüssel jetzt als Authorization: Bearer, nicht als X-Api-Key. Die API akzeptiert beide Header, aber ein Proxy oder Gateway, der X-Api-Key ausliest, muss angepasst werden.
• Ein Credential pro Client. Gleichzeitig einen API-Schlüssel und ein Auth-Token zu übergeben, ist jetzt ein Fehler. In Python löst das ValueError aus, in TypeScript TypeError.
• Text Completions entfernt. Die alte Completions-Schnittstelle fehlt jetzt in den SDKs für TypeScript, Go, Java und Ruby sowie in der CLI. Nutzen Sie die Messages API.
• Go-Modulpfad. Go-Code muss jeden Import auf github.com/anthropics/anthropic-sdk-go/v2 umstellen und braucht Go 1.25 oder neuer.
• PHP-Upgrade-Befehl. Ein einfaches composer update bleibt auf der alten Hauptversion. Nutzen Sie composer require, um auf 1.0.0 zu wechseln.

Auch die Lizenz ändert sich. Ab diesen Versionen stehen die SDKs und die CLI unter Apache 2.0 statt MIT. Frühere Versionen bleiben unter MIT, und laut dem Leitfaden sind dafür keine Codeänderungen nötig.

Später am 21. Oktober ergänzten Python SDK 2.1.0 und TypeScript SDK 1.1.0 die Nutzerprofile um Durchsetzungsstatus und Durchsetzungsmaßnahmen. Das ist eine eigene Funktion und nicht Teil des Versionswechsels.

Was das für Entwickler bedeutet

Nichts bricht, bis Sie eine SDK-Hauptversion aktualisieren oder den Header selbst ändern. Das verschafft Zeit, aber die Release Notes nennen kein Abschaltdatum für 2023-06-01. Planen Sie den Wechsel, statt auf ein solches Datum zu warten.

• Zuerst nach Sampling-Einstellungen suchen. Finden Sie jeden Aufruf, der temperature, top_p oder top_k setzt, auch in Wrappern und Konfigurationsdateien. Jeder davon wird nach dem Upgrade zu einem 400-Fehler.
• Prüfen, was zwischen Ihnen und der API sitzt. Ein Logging-Proxy, ein Gateway oder ein Secret-Scanner, der X-Api-Key ausliest, sieht den Schlüssel nicht mehr, sobald das SDK Authorization: Bearer sendet.
• Die Hauptversion im Lockfile festschreiben. Ein nicht fixierter Versionsbereich für anthropic oder @anthropic-ai/sdk kann bei der nächsten Installation auf die neue Hauptversion springen. Aktualisieren Sie bewusst und mit Tests.
• Gespeicherte Unterhaltungen prüfen. Wenn Sie gespeicherte Nachrichtenverläufe erneut abspielen, prüfen Sie sie auf Dokumente in Assistant-Turns oder Zitate in User-Turns.
• Die Lizenzverantwortlichen informieren. Die neuen Hauptversionen stehen unter Apache 2.0, nicht unter MIT. Halten Sie die Änderung fest, bevor das Upgrade ausgeliefert wird.