Beta-Header

Beta-Header ermöglichen dir den Zugriff auf experimentelle Features und neue Modellfähigkeiten, bevor sie Teil der Standard-API werden.



So verwendest du Beta-Header

Um auf Beta-Features 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 jedes Features gibt den genauen Beta-Namen an, der gesendet werden muss. Die API-Übersicht listet die APIs auf, die sich derzeit in der Beta befinden.

Die folgenden Beispiele zeigen dieselbe Anfrage mit cURL, der ant-CLI und den SDKs. 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-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)

print(response.content)



Mehrere Beta-Features

Um mehrere Beta-Features in einer einzigen Anfrage zu verwenden, füge alle Feature-Namen durch Kommas getrennt in den Header ein:

anthropic-beta: feature1,feature2,feature3

Wenn du ein SDK verwendest, liste jedes Feature im betas-Parameter auf (zum Beispiel betas=["feature1", "feature2"]). Mit der CLI übergibst du ein einzelnes --beta-Flag mit den durch Kommas getrennten Feature-Namen (zum Beispiel --beta feature1,feature2). Vermeide es, das Flag zu wiederholen: Derzeit wird nur der Wert des ersten Flags wirksam.



Endpunktspezifische Header

Einige Beta-APIs sind auf bestimmte Endpunkte beschränkt und erfordern bei jeder Anfrage einen feature-spezifischen 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. Siehe die Managed-Agents-Übersicht und die MCP-Tunnels-Referenz für Details.



Namenskonventionen für Versionen

Beta-Feature-Namen folgen typischerweise dem Muster feature-name-YYYY-MM-DD, wobei das Datum angibt, wann die Beta veröffentlicht wurde. Verwende immer den exakten Beta-Feature-Namen, wie er dokumentiert ist.



Fehlerbehandlung

Wenn du einen ungültigen Beta-Namen verwendest oder eine Beta, 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

Für Updates zu Beta-Features siehe die Versionshinweise. Für Hilfe bei Produktionsproblemen kontaktiere den Support.



Nächste Schritte