错误码说明

当请求发生异常时,平台会返回对应的错误码和错误信息。以下是完整的错误码列表:

通用错误

错误码 含义 常见场景
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