错误码

HTTP 状态	error.type	含义
401	`authentication_error`	API Key 无效或缺失
400	`invalid_request`	请求格式错误
402	`insufficient_balance` / `limit_exceeded`	余额不足或超出消费限额
429	`concurrency_exceeded` / `qpm_exceeded` / `qpm_exceeded_fallback` / `upstream_rate_limited`	触发限流
502	`adapter_error`	上游模型适配异常
503	`model_unavailable`	模型不可用

限流错误类型因协议而异：OpenAI 兼容端点（/v1/chat/completions 等）返回 concurrency_exceeded / qpm_exceeded / qpm_exceeded_fallback / upstream_rate_limited；Anthropic 端点（/v1/messages）返回 rate_limit_error。详见下方「错误响应格式」。

错误响应格式

OpenAI 兼容端点（/v1/chat/completions 等）：


{
  "error": { "message": "详细原因", "type": "authentication_error" }
}

Anthropic 端点（/v1/messages）：


{
  "type": "error",
  "error": { "type": "authentication_error", "message": "详细原因" }
}