Fehler

​

HTTP-Fehler

Unsere API folgt einem vorhersehbaren 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, auf die angegebene Ressource zuzugreifen.

• 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 den internen Systemen von Anthropic aufgetreten.

• 529 - overloaded_error: Die API von Anthropic ist vorübergehend überlastet.

  Plötzliche große Nutzungssteigerungen können zu einer erhöhten Rate von 529-Fehlern führen. Wir empfehlen, die Nutzung schrittweise zu steigern und konsistente Nutzungsmuster beizubehalten.

Beim Empfang einer Streaming-Antwort über SSE ist es möglich, dass ein Fehler nach der Rückgabe einer 200-Antwort auftritt, wobei die Fehlerbehandlung nicht diesen Standardmechanismen folgt.

​

Fehlerformen

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

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

Gemäß unserer Versionierungsrichtlinie können wir die Werte innerhalb dieser Objekte erweitern, und es ist möglich, dass die type-Werte im Laufe der Zeit zunehmen werden.

​

Anfrage-ID

Jede API-Antwort enthält einen eindeutigen request-id-Header. Dieser Header enthält einen Wert wie req_018EeWyXxfu5pfWkrYcMdjWG. Wenn Sie sich wegen einer bestimmten Anfrage an den Support wenden, geben Sie bitte diese ID an, damit wir Ihr Problem schnell lösen können.

Unsere offiziellen SDKs stellen diesen Wert als Eigenschaft auf Antwort-Objekten der obersten Ebene bereit, die den Wert des x-request-id-Headers enthält:

​

Lange Anfragen

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

• 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 ihrer Zuverlässigkeit; unsere Message Batches API kann Ihnen helfen, das Risiko von Netzwerkproblemen zu managen, indem Sie nach Ergebnissen abfragen können, anstatt eine ununterbrochene Netzwerkverbindung zu benötigen.

Wenn Sie eine direkte API-Integration entwickeln, sollten Sie wissen, dass das Setzen eines TCP-Socket-Keep-alive die Auswirkungen von Zeitüberschreitungen bei inaktiven Verbindungen in einigen Netzwerken reduzieren kann.

Unsere SDKs überprüfen, dass Ihre nicht-streamenden Messages API-Anfragen voraussichtlich keine 10-Minuten-Zeitüberschreitung überschreiten und setzen außerdem eine Socket-Option für TCP-Keep-alive.