HTTP 状态码
| 状态 | 含义 | 常见原因 |
|---|---|---|
| 400 | 请求无效 | 参数缺失 / 格式错误 |
| 401 | 未鉴权 | 密钥缺失或错误 |
| 403 | 禁止 | 密钥被吊销 / 无该模型权限 |
| 404 | 不存在 | 路径或模型不存在 |
| 429 | 限流 | 见限流 |
| 5xx | 上游 / 网关错误 | 重试或联系支持 |
业务错误码
错误响应error.code 字段的可能取值：
| code | 含义 | 处理 |
|---|---|---|
invalid_request | 请求参数无效 | 校对参数与请求体 |
bad_request_body | 请求体格式错误 | 检查 JSON 是否合法 |
read_request_body_failed | 读取请求体失败 | 检查请求体与 Content-Type |
convert_request_failed | 请求转换失败 | 检查参数是否符合该接口格式 |
sensitive_words_detected | 触发敏感词 | 调整输入内容 |
prompt_blocked | 提示被拦截 | 调整提示内容 |
access_denied | 无访问权限 | 检查密钥、权限与分组 |
model_not_found | 模型不存在 | 确认 model 名与套餐可用模型 |
invalid_api_type | 接口类型不支持 | 使用受支持的接口格式 |
get_channel_failed | 无可用渠道 | 稍后重试或联系支持 |
channel:no_available_key | 渠道无可用密钥 | 稍后重试或联系支持 |
channel:invalid_key | 渠道密钥无效 | 联系支持 |
channel:model_mapped_error | 模型映射错误 | 联系支持 |
channel:response_time_exceeded | 上游响应超时 | 重试；必要时减小请求 |
insufficient_user_quota | 额度不足 | 充值或检查套餐额度 |
pre_consume_token_quota_failed | 预扣额度失败 | 检查额度后重试 |
model_price_error | 模型计价异常 | 联系支持 |
count_token_failed | token 统计失败 | 检查输入后重试 |
do_request_failed | 请求上游失败 | 重试 |
bad_response | 上游响应异常 | 重试或联系支持 |
bad_response_status_code | 上游返回异常状态码 | 重试或联系支持 |
empty_response | 上游空响应 | 重试；流式可增大超时 |
read_response_body_failed | 读取上游响应失败 | 重试 |
json_marshal_failed | 序列化失败 | 重试或联系支持 |
query_data_error | 数据查询错误 | 重试或联系支持 |
update_data_error | 数据写入错误 | 重试或联系支持 |