错误码说明
当请求发生异常时,平台会返回对应的错误码和错误信息。以下是完整的错误码列表:
通用错误
| 错误码 |
含义 |
常见场景 |
invalid_request |
无效请求 |
请求参数格式错误、缺少必需字段 |
bad_request_body |
错误的请求体 |
请求体 JSON 解析失败 |
read_request_body_failed |
读取请求体失败 |
请求体过大或传输中断 |
convert_request_failed |
转换请求失败 |
请求格式转换异常 |
access_denied |
访问被拒绝 |
无权限访问该接口或模型 |
json_marshal_failed |
JSON 序列化失败 |
内部数据序列化异常 |
do_request_failed |
请求执行失败 |
网络异常或上游服务不可用 |
gen_relay_info_failed |
生成转发信息失败 |
内部路由信息生成失败 |
get_channel_failed |
获取渠道失败 |
无法找到可用的上游渠道 |
invalid_api_type |
无效 API 类型 |
请求的 API 类型不被支持 |
模型相关错误
| 错误码 |
含义 |
常见场景 |
model_not_found |
模型未找到 |
请求的模型 ID 不存在或已退役 |
model_price_error |
模型价格错误 |
模型计费配置异常 |
count_token_failed |
Token 计数失败 |
无法计算输入/输出的 token 数量 |
prompt_blocked |
提示词被拦截 |
输入内容触发安全策略被拦截 |
sensitive_words_detected |
检测到敏感词 |
输入内容包含敏感词汇 |
渠道错误
| 错误码 |
含义 |
常见场景 |
channel:no_available_key |
无可用密钥 |
当前渠道的所有密钥均不可用 |
channel:invalid_key |
无效密钥 |
渠道密钥配置错误或已过期 |
channel:response_time_exceeded |
渠道响应超时 |
上游渠道响应时间超过阈值 |
channel:param_override_invalid |
参数覆盖无效 |
渠道参数覆盖配置错误 |
channel:header_override_invalid |
请求头覆盖无效 |
渠道请求头覆盖配置错误 |
channel:model_mapped_error |
模型映射错误 |
渠道模型映射配置异常 |
channel:aws_client_error |
AWS 客户端错误 |
AWS 渠道客户端初始化失败 |
响应错误
| 错误码 |
含义 |
常见场景 |
bad_response_status_code |
错误的响应状态码 |
上游返回非 200 状态码 |
bad_response |
错误响应 |
上游返回异常响应 |
bad_response_body |
错误响应体 |
上游返回的响应体解析失败 |
read_response_body_failed |
读取响应体失败 |
无法读取上游响应内容 |
empty_response |
空响应 |
上游返回空内容 |
aws_invoke_error |
AWS 调用错误 |
AWS 服务调用失败 |
额度错误
| 错误码 |
含义 |
常见场景 |
insufficient_user_quota |
用户额度不足 |
账户余额不足,无法完成请求 |
pre_consume_token_quota_failed |
预扣额度失败 |
请求前额度预扣失败 |
数据错误
| 错误码 |
含义 |
常见场景 |
query_data_error |
查询数据错误 |
数据库查询失败 |
update_data_error |
更新数据错误 |
数据库更新失败 |
特殊错误
| 错误码 |
含义 |
常见场景 |
violation_fee.grok.csam |
Grok CSAM 违规费用 |
Grok 模型检测到违规内容产生额外费用 |
api_not_implemented |
API 未实现 |
请求的接口暂未实现(如图片变体、文件操作、微调等) |
rate_limit_check_failed |
限流检查失败 |
模型请求频率超过限制 |
playground_guest_rate_limit |
Playground 游客限流 |
Playground 游客模式请求过于频繁 |
错误响应格式
OpenAI 兼容格式(默认):
{
"error": {
"message": "错误描述信息",
"type": "dashboard_api_error",
"param": "",
"code": "model_not_found"
}
}
Claude 原生格式(/v1/messages 路径):
{
"type": "error",
"error": {
"type": "upstream_error",
"message": "错误描述信息"
}
}
未实现接口格式:
{
"error": {
"message": "API not implemented",
"type": "dashboard_api_error",
"code": "api_not_implemented"
}
}
HTTP 状态码参考
| HTTP 状态码 |
含义 |
| 200 |
请求成功 |
| 400 |
请求参数错误 |
| 401 |
认证失败(API Key 无效或缺失) |
| 403 |
权限不足 |
| 404 |
资源不存在 |
| 429 |
请求过于频繁(限流) |
| 500 |
服务器内部错误 |
| 502 |
上游服务错误 |
| 503 |
服务暂时不可用 |
| 504 |
上游服务超时 |
作者:李志强 创建时间:2026-06-04 15:18
最后编辑:李志强 更新时间:2026-06-11 16:52