错误码参考

当请求发生错误时，API 返回标准错误格式：

{
  "error": {
    "message": "错误描述信息",
    "type": "错误类型",
    "code": "错误码"
  }
}

常见错误码

HTTP 状态码	error.code	error.type	说明
400	invalid_request	invalid_request_error	请求参数无效
400	invalid_model	invalid_request_error	模型 ID 不存在或不可用
400	invalid_messages	invalid_request_error	messages 格式错误
401	invalid_api_key	authentication_error	API Key 无效或已过期
403	insufficient_balance	forbidden_error	账户余额不足
403	permission_denied	forbidden_error	无权限访问该资源
404	model_not_found	not_found_error	请求的模型不存在
429	rate_limit_exceeded	rate_limit_error	请求频率超过限制
500	internal_error	server_error	服务器内部错误
502	upstream_error	server_error	上游模型服务不可用
503	service_unavailable	server_error	服务暂时不可用
504	timeout	server_error	请求超时

排查建议

错误	排查方向
invalid_api_key	检查 API Key 是否正确，是否已过期或被删除
insufficient_balance	登录 Portal 查看余额，充值后重试
rate_limit_exceeded	降低请求频率，或联系管理员提升限额
model_not_found	使用 GET /api/v1/models 确认模型是否可用
upstream_error	上游服务暂时不可用，稍后重试

健康检查

GET /health

无需认证，用于检查 Gateway 服务状态。

{
  "status": "UP"
}