Claude Platform Docs
API-ReferenzAPI verwenden

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
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 dem SDK, wobei die Beta für Kontextbearbeitung als Beispiel dient. 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,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

Liste 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, Microsoft Foundry und Google Cloud nehmen Beta-Namen im anthropic-beta-Header entgegen, genau wie die Claude API. Um mehrere Betas zu senden, füge ihre Namen durch Kommas getrennt in einen Header ein: Google Cloud liest nur einen anthropic-beta-Header und ignoriert die übrigen, sodass Betas in den anderen Headern 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 im anthropic-beta-Header entgegen.
  • Die InvokeModel API liest sie aus dem Anfragetext, nicht aus einem Header. Liste sie im anthropic_beta-Array des Anfragetexts 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:

EndpunkteBeta-Header
/v1/agents, /v1/sessions, /v1/environmentsmanaged-agents-2026-04-01
/v1/tunnelsmcp-tunnels-2026-06-22
/v1/memory_stores und Unterressourcenagent-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:

Output
{
  "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

Fehler

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.

API-Übersicht

Entdecke die Funktionen der Claude API, einschließlich der APIs, die sich derzeit in der Beta-Phase befinden.

Was this page helpful?