Beta-Header

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
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
anthropic-beta: BETA_FEATURE_NAME
content-type: application/json

Die Dokumentation jeder Funktion gibt den genauen Beta-Namen an, der gesendet werden muss. Die API-Übersicht listet die APIs auf, die sich derzeit in der Beta-Phase befinden.

Die folgenden Beispiele zeigen dieselbe Anfrage mit cURL, der ant-CLI und den SDKs, wobei die Beta für Kontextbearbeitung als Beispiel dient. Die SDKs nehmen Beta-Namen im betas-Parameter entgegen und senden 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,feature3

Du 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: feature3

Wenn du ein SDK verwendest, liste jede Funktion im betas-Parameter auf (zum Beispiel betas=["feature1", "feature2"]). Übergib bei 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).

Endpunktspezifische Header

Einige Beta-APIs sind auf bestimmte Endpunkte beschränkt und erfordern bei jeder Anfrage einen funktionsspezifischen Beta-Header:

Die beta-Namespaces der SDKs fügen diese Header automatisch hinzu. Füge sie nur selbst hinzu, wenn du rohe HTTP-Anfragen stellst. Details findest du in der Übersicht zu Managed Agents, unter Agent-Speicher verwenden und in der Referenz zu MCP-Tunneln.

Endpunktspezifische Header, die für denselben Endpunkt gelten, sind nicht immer kombinierbar. Bei Memory-Store-Endpunkten ersetzt agent-memory-2026-07-22 den Header managed-agents-2026-04-01: Werden beide in derselben Anfrage gesendet, wird ein 400-Fehler zurückgegeben. Die Client-SDKs senden 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