Claude Platform Docs
API-ReferenzDie API 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
Authorization: Bearer YOUR_API_KEY
anthropic-version: 2026-10-21
anthropic-beta: BETA_FEATURE_NAME
content-type: application/json

Die 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,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, 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 im anthropic-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:

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

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?