Beta-Header ermöglichen Ihnen 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.
Beta-Header werden oft in Verbindung mit dem Beta-Namespace in den Client-SDKs verwendet

​
Verwendung von Beta-Headern

Um auf Beta-Funktionen zuzugreifen, fügen Sie den anthropic-beta-Header in Ihre 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 können Sie Beta-Header in den Anfrage-Optionen angeben: 
from anthropic import Anthropic

client = Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    betas=["beta-feature-name"]
)
Beta-Funktionen sind experimentell und können:
  • Breaking Changes ohne Vorankündigung haben
  • Veraltet oder entfernt werden
  • Unterschiedliche Ratenlimits oder Preise haben
  • Nicht in allen Regionen verfügbar sein

​
Mehrere Beta-Funktionen

Um mehrere Beta-Funktionen in einer einzigen Anfrage zu verwenden, fügen Sie alle Funktionsnamen im Header durch Kommas getrennt ein: 
anthropic-beta: feature1,feature2,feature3

​
Versionsnamenkonventionen

Beta-Funktionsnamen folgen typischerweise dem Muster: feature-name-YYYY-MM-DD, wobei das Datum angibt, wann die Beta-Version veröffentlicht wurde. Verwenden Sie immer den exakten Beta-Funktionsnamen wie dokumentiert.

​
Fehlerbehandlung

Wenn Sie einen ungültigen oder nicht verfügbaren Beta-Header verwenden, erhalten Sie eine Fehlerantwort: 
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}

​
Hilfe erhalten

Für Fragen zu Beta-Funktionen:
  1. Überprüfen Sie die Dokumentation für die spezifische Funktion
  2. Schauen Sie sich das API-Changelog für Updates an
  3. Kontaktieren Sie den Support für Hilfe bei der Produktionsnutzung
Denken Sie daran, dass Beta-Funktionen “wie sie sind” bereitgestellt werden und möglicherweise nicht die gleichen SLA-Garantien wie stabile API-Funktionen haben.