完整的 HTTP 状态码和业务错误码说明，帮助您快速定位和解决问题
请求成功，服务器正常返回数据
✓ 正常响应状态
资源创建成功（如创建 API Key、组织）
✓ POST 请求成功创建资源
请求参数错误或格式不正确
解决方案：检查请求参数格式、类型和必填字段
认证失败，API Key 无效或已过期
解决方案：检查 Authorization header 格式：Bearer YOUR_API_KEY
权限不足，无法访问该资源
解决方案：检查用户角色和权限设置，管理员功能需要 Admin 权限
请求的资源不存在
解决方案：检查 URL 路径、资源 ID 是否正确
资源冲突（如邮箱已被注册）
解决方案：使用不同的邮箱或资源名称
API Key 无效或格式错误
解决方案：
Bearer sk-xxx...API Key 已过期或被禁用
解决方案：
用户认证失败（邮箱或密码错误）
解决方案：
权限不足，无法执行该操作
常见场景：
| 错误码 | 说明 | HTTP | 解决方案 |
|---|---|---|---|
| INVALID_REQUEST | 请求参数无效 | 400 | 检查请求体格式和必填字段 |
| MODEL_NOT_FOUND | 请求的模型不存在 | 404 | 查看支持的模型列表 |
| CONTEXT_LENGTH_EXCEEDED | 上下文长度超出限制 | 400 | 减少输入内容或使用更大上下文窗口的模型 |
| ROUTING_FAILED | 智能路由解析失败 | 400 | 检查模型名称格式，如 gpt-4:openai |
| USER_NOT_FOUND | 用户不存在 | 404 | 确认用户 ID 正确 |
| EMAIL_ALREADY_REGISTERED | 邮箱已被注册 | 409 | 使用其他邮箱或直接登录 |
| RESOURCE_NOT_FOUND | 资源不存在（组织、告警等） | 404 | 检查资源 ID 是否正确 |
| DATABASE_ERROR | 数据库操作失败 | 500 | 稍后重试，持续失败请联系支持 |
AI 提供商暂时不可用
原因：
解决方案：
没有可用的 API Key
提供商 API Key 无效
解决方案：
主提供商失败且故障转移也失败
原因：所有配置的提供商都不可用
解决方案：
支付失败
可能原因：
解决方案：
促销码无效或已过期
原因：
{
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid API key provided",
"type": "authentication_error",
"param": null,
"details": "API key format is incorrect"
}
}| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 错误码标识符 |
| message | string | 错误描述（英文） |
| type | string | 错误类型（authentication_error, validation_error, provider_error, system_error） |
| param | string | 相关参数名称（可选） |
| details | string | 详细错误信息（可选） |