Beta-Header

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

Diese Funktionen können sich ändern und in zukünftigen Versionen modifiziert oder entfernt 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
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

Bei Verwendung des SDK kannst du Beta-Header in den Request-Optionen angeben:

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"],
)



Mehrere Beta-Funktionen

Um mehrere Beta-Funktionen in einer einzigen Anfrage zu verwenden, gib alle Funktionsnamen im Header durch Kommas getrennt an:

anthropic-beta: feature1,feature2,feature3



Endpunktspezifische Header

Einige Beta-Funktionen sind auf bestimmte Endpunkte beschränkt und nicht auf einzelne Request-Parameter bezogen. Sie erfordern bei jeder Anfrage einen funktionsspezifischen Beta-Header:

Weitere Details findest du in der Übersicht zu Managed Agents und in der MCP-Tunnels-Referenz.



Namenskonventionen für Versionen

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



Fehlerbehandlung

Wenn du einen ungültigen oder nicht verfügbaren Beta-Header verwendest, erhältst du eine Fehlerantwort:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}



Hilfe erhalten

Bei Fragen zu Beta-Funktionen:

1. Sieh dir die Dokumentation für die jeweilige Funktion an
2. Überprüfe das API-Changelog auf Updates
3. Kontaktiere den Support für Unterstützung bei der Nutzung in Produktionsumgebungen

Beachte, dass Beta-Funktionen „wie besehen" bereitgestellt werden und möglicherweise nicht dieselben SLA-Garantien wie stabile API-Funktionen bieten.