API-ReferenzSupport & Konfiguration
API-Versionen
Bei API-Anfragen musst du einen anthropic-version-Request-Header senden. Zum Beispiel anthropic-version: 2026-10-21. Wenn du das Client-SDK(wird in neuem Tab geöffnet) verwendest, setzt es diesen Header für dich.
Für jede gegebene API-Version bewahrt Anthropic:
- Bestehende Eingabeparameter
- Bestehende Ausgabeparameter
Anthropic kann jedoch Folgendes tun:
- Zusätzliche optionale Eingaben hinzufügen
- Zusätzliche Werte zur Ausgabe hinzufügen
- Bedingungen für bestimmte Fehlertypen ändern
- Neue Varianten zu Enum-ähnlichen Ausgabewerten hinzufügen (zum Beispiel Streaming-Event-Typen)
Im Allgemeinen gilt: Wenn du die API so verwendest, wie sie in dieser Referenz dokumentiert ist, wird Anthropic deine Nutzung nicht beeinträchtigen.
Versionsverlauf
Anthropic empfiehlt, wann immer möglich die neueste API-Version zu verwenden.
2026-10-21- Migration zu API-Version 2026-10-21 zeigt, wie du upgradest.
- Verfügbar in der Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Claude Models on Google Cloud (Google managed) und Microsoft Foundry. Auf Amazon Bedrock ist sie für Claude 4.7 und neuere Modelle verfügbar. Für frühere Claude-Modelle auf Bedrock behältst du die API-Version bei, die du heute verwendest.
- Messages API:
- Eine Anfrage, die einen
document-Block direkt in einerassistant-Nachricht platziert, gibt einen 400-Fehler zurück. - Das Senden eines
text-Blocks mit einem nicht leerencitations-Array in eineruser-Nachricht, direkt oder innerhalb einessearch_result-Blocks, gibt einen 400-Fehler zurück. - Die Request-Parameter
temperature,top_pundtop_kwurden entfernt. Eine Anfrage, die einen davon sendet, gibt bei jedem Modell einen 400-Fehler zurück.
- Eine Anfrage, die einen
- Admin API:
- RBAC-GruppenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein
rolesmehr zurück. Verwende stattdessenrole_ids. - RBAC-GruppenmitgliederVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und die Antwort auf das Entfernen eines Mitglieds geben kein
group_idmehr zurück. Verwende stattdessenrbac_group_id. - RBAC-RollenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein
namemehr zurück. Verwende stattdessendisplay_name. - Einträge für „rate limits“ (Ratenlimits) auf Organisations-Vorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und Workspace-EbeneVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. sowie die Antwort auf das Festlegen der Ratenlimits eines WorkspaceVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein
group_typemehr zurück. Verwende stattdessengroup.type. - API-KeysVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein
workspace_idmehr zurück. Verwende stattdessenscope.workspace_id. Es enthält die ID des Workspace des Keys, einschließlich des Standard-Workspace. Ein Key für alle Workspaces hat keinscope.workspace_id.
- RBAC-GruppenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. geben kein
- Claude Enterprise Analytics API:
- Die nutzerbezogenen Berichte zu NutzungVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und KostenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. enthalten kein
actor.emailmehr. Verwende stattdessenactor.email_address. - Die Antwort der AktivitätszusammenfassungenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. enthält kein
summariesmehr. Verwende stattdessendata.
- Die nutzerbezogenen Berichte zu NutzungVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. und KostenVorschau mit Links zur API-Referenz verfügbar – drücke Tab, bis der Fokus in die Karte wechselt, und Escape, um zurückzukehren. enthalten kein
2023-06-01- Neues Format für Streaming von „server-sent events“ (vom Server gesendete Ereignisse), oder SSE:
- Completions sind inkrementell. Zum Beispiel
" Hello"," my"," name"," is"," Claude."anstelle von" Hello"," Hello my"," Hello my name"," Hello my name is"," Hello my name is Claude.". - Alle Events sind benannte Events statt reiner Daten-Events.
- Unnötiges
data: [DONE]-Event entfernt.
- Completions sind inkrementell. Zum Beispiel
- Veraltete
exception- undtruncated-Werte in Antworten entfernt.
- Neues Format für Streaming von „server-sent events“ (vom Server gesendete Ereignisse), oder SSE:
2023-01-01: Erstveröffentlichung.
War diese Seite hilfreich?