错误处理 - APIAny.AI Docs

每个对话接口都返回与其兼容的 API 标准（OpenAI / Anthropic / Gemini）一致的错误结构。所有错误响应都带 X-Request-Id 响应头，只返回你排查请求所需的信息。

OpenAI — `/v1/chat/completions`（以及图片/视频接口）

{
  "error": {
    "message": "Insufficient credits",
    "type": "insufficient_quota",
    "code": "insufficient_credits",
    "param": null
  }
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": 400,
    "message": "model is required",
    "status": "INVALID_ARGUMENT"
  }
}

错误的 type / status 由 HTTP 状态码推导：

HTTP	OpenAI `type`	Anthropic `type`	Gemini `status`
400	invalid_request_error	invalid_request_error	INVALID_ARGUMENT
401	authentication_error	authentication_error	UNAUTHENTICATED
403	permission_error	permission_error	PERMISSION_DENIED
404	not_found_error	not_found_error	NOT_FOUND
402	insufficient_quota	invalid_request_error	RESOURCE_EXHAUSTED
429	rate_limit_error	rate_limit_error	RESOURCE_EXHAUSTED
5xx	api_error	api_error / overloaded_error	INTERNAL / UNAVAILABLE