错误码

错误响应体

请求失败时,平台返回统一格式的 JSON 错误体,HTTP 状态码见下方错误码表:

{
  "error": {
    "message": "human readable message",
    "type": "insufficient_credits",
    "code": "insufficient_credits",
    "request_id": "..."
  }
}

message:面向人类的错误描述,仅用于调试参考,不建议按内容做逻辑判断。
type 与 code:取值始终相同,均为下方错误码表中的 code。
request_id:本次请求的唯一标识,联系支持排查问题时请提供该值。

错误码总表

code	HTTP	适用接口	触发场景
`invalid_api_key`	401	全部 `/v1/*` 接口	`Authorization` 头缺失/格式错误,或 API Key 无效/已禁用
`invalid_request`	400	Chat、图像生成	请求体不合法(如缺失 `model`/`messages`、gemini 系列模型 `n>1`、`prompt` 缺失等)
`invalid_request_error`	400	视频生成	请求体不合法(非法 JSON、`callback_url` 非字符串或不满足 https/公网地址要求等)
`model_not_allowed`	403	Chat、图像生成	请求的 `model` 不在该 API Key 的模型白名单内
`quota_exceeded`	403	Chat	该 API Key 的配额已用尽(仅 Chat 接口触发)
`model_not_found`	404	Chat、图像生成、视频生成	平台没有该模型
`task_not_found`	404	视频生成	查询任务时 `task_id` 不存在,或不属于当前账户
`insufficient_credits`	402	Chat、图像生成、视频生成	账户余额不足以覆盖预扣费用
`upstream_error`	502	Chat、图像生成、视频生成	上游服务返回错误,或平台重试耗尽;已扣费的场景会退还费用(具体见各接口文档)
`no_available_channel`	503	Chat、图像生成、视频生成	该模型当前没有可用渠道
`internal_error`	500	全部 `/v1/*` 接口	平台内部错误

重试建议

5xx(upstream_error、no_available_channel、internal_error):可按指数退避策略重试;upstream_error 与 no_available_channel 通常是暂时性的。
4xx:先根据 message 修正请求参数或账户状态后再发起,重试不会改变结果(如 insufficient_credits 需先充值,invalid_api_key 需检查 key)。

错误码

错误响应体

错误码总表

重试建议

本页内容