Beta-Header
Greife mit dem anthropic-beta-Header oder dem betas-Parameter des SDK auf experimentelle Funktionen zu, bevor sie Teil der Standard-API werden.
Beta-Header ermöglichen dir den Zugriff auf experimentelle Funktionen und neue Modellfähigkeiten, bevor sie Teil der Standard-API werden.
So verwendest du Beta-Header
Um auf Beta-Funktionen zuzugreifen, füge den anthropic-beta-Header in deine API-Anfragen ein:
POST /v1/messages
Authorization: Bearer YOUR_API_KEY
anthropic-version: 2026-10-21
anthropic-beta: BETA_FEATURE_NAME
content-type: application/jsonDie Dokumentation jeder Funktion gibt den genauen Beta-Namen an, den du senden musst. Die API-Übersicht listet die APIs in der Beta auf.
Das folgende Beispiel sendet eine Anfrage mit der Context-Editing-Beta. Das SDK nimmt Beta-Namen über betas entgegen und sendet den anthropic-beta-Header für dich:
client = Anthropic()
response = client.beta.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello, Claude"}],
betas=["context-management-2025-06-27"],
)
print(response.content)Mehrere Beta-Funktionen
Um mehrere Beta-Funktionen in einer einzigen Anfrage zu verwenden, füge alle Funktionsnamen durch Kommas getrennt in den Header ein:
anthropic-beta: feature1,feature2,feature3Du kannst den anthropic-beta-Header auch mehrmals in derselben Anfrage senden. Die Claude API liest jeden anthropic-beta-Header, daher ist Folgendes gleichwertig zum vorherigen Beispiel:
anthropic-beta: feature1
anthropic-beta: feature2
anthropic-beta: feature3Liste mit dem SDK jede Funktion auf (zum Beispiel betas=["feature1", "feature2"]). Übergib mit der CLI ein einzelnes --beta-Flag mit den durch Kommas getrennten Funktionsnamen (zum Beispiel --beta feature1,feature2). Du kannst das Flag auch wiederholen (zum Beispiel --beta feature1 --beta feature2).
Beta-Funktionen auf anderen Plattformen
Beta-Namen sind auf jeder Plattform, die sie akzeptiert, gleich, aber nicht jede Plattform akzeptiert jede Beta. Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed), Microsoft Foundry und Claude Models on Google Cloud (Google managed) nehmen Beta-Namen im anthropic-beta-Header entgegen, so wie die Claude API. Um mehrere Betas zu senden, setze ihre Namen durch Kommas getrennt in einen Header: Claude Models on Google Cloud (Google managed) liest nur einen anthropic-beta-Header und ignoriert die übrigen, sodass Betas in den anderen nicht wirksam werden.
Bei Amazon Bedrock hängt es von der aufgerufenen API ab, wo die Beta-Namen angegeben werden:
- Claude in Amazon Bedrock (
bedrock-mantle-Endpunkte) nimmt sie imanthropic-beta-Header entgegen. - Die InvokeModel API liest sie aus dem Request-Body, nicht aus einem Header. Liste sie im
anthropic_beta-Array des Bodys auf, ein Name pro Element, zum Beispiel"anthropic_beta": ["feature1", "feature2"].
Endpunktspezifische Header
Einige Beta-APIs sind auf bestimmte Endpunkte beschränkt und erfordern bei jeder Anfrage einen funktionsspezifischen Beta-Header:
| Endpunkte | Beta-Header |
|---|---|
/v1/agents, /v1/sessions, /v1/environments | managed-agents-2026-04-01 |
/v1/tunnels | mcp-tunnels-2026-06-22 |
/v1/memory_stores und Unterressourcen | agent-memory-2026-07-22 |
Der client.beta-Namespace des SDK fügt diese Header automatisch hinzu. Füge sie nur selbst hinzu, wenn du rohe HTTP-Anfragen stellst. Details findest du in der Managed-Agents-Übersicht, unter Agent-Memory verwenden und in der MCP-Tunnel-Referenz.
Endpunktspezifische Header, die für denselben Endpunkt gelten, lassen sich nicht immer kombinieren. Bei Memory-Store-Endpunkten ersetzt agent-memory-2026-07-22 den Header managed-agents-2026-04-01: Wenn du beide in derselben Anfrage sendest, wird ein 400-Fehler zurückgegeben. Das SDK sendet automatisch den richtigen Header für jeden Endpunkt.
Konventionen für die Versionsbenennung
Namen von Beta-Funktionen folgen in der Regel dem Muster feature-name-YYYY-MM-DD, wobei das Datum angibt, wann die Beta veröffentlicht wurde. Verwende immer den genauen Namen der Beta-Funktion, wie er dokumentiert ist.
Fehlerbehandlung
Wenn du einen ungültigen Beta-Namen oder eine Beta verwendest, auf die deine Organisation keinen Zugriff hat, erhältst du eine 400-Fehlerantwort:
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header."
},
"request_id": "req_011CcnGfC9fELffo2EALu4Wd"
}Hilfe erhalten
Aktualisierungen zu Beta-Funktionen findest du in den Versionshinweisen. Bei Problemen im Produktivbetrieb wende dich an den Support.
Nächste Schritte
Verstehe die HTTP-Statuscodes, die Struktur von Fehlerantworten und die Request-IDs, die die Claude API zurückgibt, und behandle Fehler mit den typisierten Exceptions des SDK.
Erkunde die Funktionen der Claude API, einschließlich der APIs in der Beta.
War diese Seite hilfreich?