錯誤

​

HTTP 錯誤

我們的 API 遵循可預測的 HTTP 錯誤代碼格式：

• 400 - invalid_request_error：您的請求格式或內容有問題。我們也可能將此錯誤類型用於其他未在下面列出的 4XX 狀態代碼。
• 401 - authentication_error：您的 API 金鑰有問題。
• 403 - permission_error：您的 API 金鑰沒有權限使用指定的資源。
• 404 - not_found_error：找不到請求的資源。
• 429 - rate_limit_error：您的帳戶已達到速率限制。
• 500 - api_error：Anthropic 系統內部發生意外錯誤。
• 529 - overloaded_error：Anthropic 的 API 暫時過載。

當通過 SSE 接收流式響應時，可能會在返回 200 響應後發生錯誤，在這種情況下，錯誤處理不會遵循這些標準機制。

​

錯誤形狀

錯誤始終以 JSON 形式返回，頂層有一個 error 對象，其中始終包含 type 和 message 值。例如：

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "找不到請求的資源。"
  }
}

根據我們的版本控制策略，我們可能會擴展這些對象中的值，並且 type 值可能會隨著時間的推移而增加。