Skip to content

错误码大全 ​

HTTP 状态码 ​

状态码说明常见原因处理
400请求格式错误参数缺失、类型错、size 越界查阅对应接口的参数矩阵
401未认证Key 缺失、拼写错误、已过期/删除检查 Header 格式,重新生成 Key
402余额不足额度耗尽后台充值
403无权限分组不包含该模型联系客服切换分组
404资源不存在Model ID 错、任务/模型不存在GET /v1/models 拉真实列表
408客户端超时请求耗时超过客户端超时限制加大超时(图像 300s、视频轮询不要设超时)
413请求过大上传文件超 50MB压缩文件
429速率限制短时请求过多指数退避,减速轮询
500服务端错误心流网关内部错误5s 后重试
502 / 503模型服务不可用模型商故障等待后重试,或切换线路
504模型响应超时模型响应时间超过网关超时限制减短 max_tokens

常见错误消息 ​

分组/渠道 ​

消息含义
No available channel for model xxx under group default分组不匹配
无效的令牌Key 格式错或已失效
分组 xxx 下模型 yyy 无可用渠道模型和分组都存在但无可用模型服务

参数 ​

消息含义
image size must be at least NNNNNN pixelssize 低于模型像素下限(Seedream 系)
The parameter size specified in the request is not validGPT Image 2 的尺寸不符合约束;检查最长边≤3840px、宽高为16的倍数、比例1:3~3:1、总像素 655,360~8,294,400。4K 最大为 16:9 3840x2160、1:1 2880x2880、9:16 2160x3840
cannot unmarshal number into Go struct field .Alias.seconds of type stringseconds 传了数字
duration_required / prompt is required缺少必填字段

内容审核 ​

消息含义
提交中含有违反平台政策的内容Veo 任务级审核拒绝
Your request was rejected as a result of our safety systemGPT Image 2 审核拒绝
SAFETY (finishReason)Gemini 安全过滤

账户 ​

消息含义
insufficient_quota / 余额不足余额不够本次调用
token quota exceeded令牌配额用完
rate limit exceededRPM / TPM 超限

异步任务失败 ​

视频类 status=failed:查看 error.message。

  • 审核类:换 prompt 重试
  • 技术类:等 30 秒重新 POST
  • 审核拒绝、模型服务故障都不消耗额度