​
HTTP-Fehler

Unsere API folgt einem vorhersagbaren HTTP-Fehlercode-Format:

  • 400 - invalid_request_error: Es gab ein Problem mit dem Format oder Inhalt Ihrer Anfrage. Wir können diesen Fehlertyp auch für andere 4XX-Statuscodes verwenden, die unten nicht aufgeführt sind.

  • 401 - authentication_error: Es gibt ein Problem mit Ihrem API-Schlüssel.

  • 403 - permission_error: Ihr API-Schlüssel hat keine Berechtigung, die angegebene Ressource zu verwenden.

  • 404 - not_found_error: Die angeforderte Ressource wurde nicht gefunden.

  • 413 - request_too_large: Die Anfrage überschreitet die maximal zulässige Anzahl von Bytes.

  • 429 - rate_limit_error: Ihr Konto hat ein Ratenlimit erreicht.

  • 500 - api_error: Ein unerwarteter Fehler ist in Anthropics Systemen aufgetreten.

  • 529 - overloaded_error: Anthropics API ist vorübergehend überlastet.

    529-Fehler können auftreten, wenn Anthropic APIs hohen Traffic bei allen Benutzern erfahren. In seltenen Fällen, wenn Ihre Organisation einen starken Anstieg der Nutzung hat, könnten Sie diese Art von Fehler sehen. Um 529-Fehler zu vermeiden, steigern Sie Ihren Traffic schrittweise und halten Sie konsistente Nutzungsmuster aufrecht.

Beim Empfangen einer Streaming-Antwort über SSE ist es möglich, dass ein Fehler auftreten kann, nachdem eine 200-Antwort zurückgegeben wurde, in welchem Fall die Fehlerbehandlung nicht diesen Standardmechanismen folgen würde.

​
Fehlerformen

Fehler werden immer als JSON zurückgegeben, mit einem Top-Level-error-Objekt, das immer einen type- und message-Wert enthält. Zum Beispiel:

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "The requested resource could not be found."
  }
}

In Übereinstimmung mit unserer Versionierungsrichtlinie können wir die Werte innerhalb dieser Objekte erweitern, und es ist möglich, dass die type-Werte im Laufe der Zeit wachsen werden.

​
Anfrage-ID

Jede API-Antwort enthält einen eindeutigen request-id-Header. Dieser Header enthält einen Wert wie req_018EeWyXxfu5pfWkrYcMdjWG. Wenn Sie den Support bezüglich einer spezifischen Anfrage kontaktieren, geben Sie bitte diese ID an, um uns zu helfen, Ihr Problem schnell zu lösen.

Unsere offiziellen SDKs stellen diesen Wert als Eigenschaft auf Top-Level-Antwortobjekten bereit, die den Wert des request-id-Headers enthalten:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(f"Request ID: {message._request_id}")

​
Lange Anfragen

Wir empfehlen dringend die Verwendung der Streaming Messages API oder Message Batches API für lang laufende Anfragen, insbesondere solche über 10 Minuten.

Wir empfehlen nicht, große max_tokens-Werte zu setzen, ohne unsere Streaming Messages API oder Message Batches API zu verwenden:

  • Einige Netzwerke können inaktive Verbindungen nach einer variablen Zeitspanne trennen, was dazu führen kann, dass die Anfrage fehlschlägt oder eine Zeitüberschreitung auftritt, ohne eine Antwort von Anthropic zu erhalten.
  • Netzwerke unterscheiden sich in der Zuverlässigkeit; unsere Message Batches API kann Ihnen helfen, das Risiko von Netzwerkproblemen zu verwalten, indem sie es Ihnen ermöglicht, Ergebnisse abzufragen, anstatt eine ununterbrochene Netzwerkverbindung zu erfordern.

Wenn Sie eine direkte API-Integration erstellen, sollten Sie sich bewusst sein, dass das Setzen eines TCP-Socket-Keep-Alive die Auswirkungen von Zeitüberschreitungen inaktiver Verbindungen in einigen Netzwerken reduzieren kann.

Unsere SDKs werden validieren, dass Ihre nicht-streamenden Messages API-Anfragen nicht erwartungsgemäß eine 10-Minuten-Zeitüberschreitung überschreiten werden und werden auch eine Socket-Option für TCP-Keep-Alive setzen.