下载 Markdown

更新日期

错误码

所有 /v1 错误都是同一形状:

json
{
  "error": {
    "message": "Model seedream-x is not available",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}
字段类型说明
error.messagestring可读说明,可能改文案,不要当稳定契约
error.typestringOpenAI 风格分类:authentication_error / rate_limit_error / invalid_request_error / api_error
error.paramstring | null出错字段,例如 model、id
error.codestring业务逻辑看这个

业务逻辑看 code。响应不包含 Retry-After。

codeHTTPtype何时
invalid_api_key401authentication_error缺 Key、错 Key、已吊销、租户停用
insufficient_quota429rate_limit_error余额不足且方法不是 GET(/v1/sub-accounts 管理面除外)。GET /v1/balance 在余额为 0 时仍是 200,balance 为 "0.00"
management_forbidden403invalid_request_error用子账户 Key 调用 /v1/sub-accounts 管理接口
rate_limit_exceeded429rate_limit_error该 Key 该能力超过 RPM
invalid_request400invalid_request_error请求体校验失败(缺字段、类型不对)
model_not_found404invalid_request_error模型不可用;任务不存在;视频未完成时取 content
capability_not_enabled400invalid_request_error模型能力与路径不符,或该能力未实现
upstream_error502api_error模型服务失败或转存失败;不透出原始错误细节
upstream_unavailable503 / 400api_error 或 invalid_request_error服务暂不可用,或当前无法完成请求
gateway_timeout504api_error网关等待模型服务超时,未扣费
content_policy_violation400invalid_request_error内容策略拒绝(若映射到此码);多数情况下仍表现为 upstream_error

对话流里的错误

stream: true 时,模型调用失败可能仍是 HTTP 200。事件流里会出现:

data: {"error":{"message":"模型服务请求失败","type":"api_error","param":null,"code":"upstream_error"}}

data: [DONE]

解析 SSE 时先看有没有 error,再拼 delta.content。

转存失败

图/视频生成成功但对象存储写入失败时,对外仍是 upstream_error,message 为「转存失败」,不会把临时链接交给你。视频模型关闭产物转存时不走对象存储,会直接返回上游地址;若无法安全直出则自动回退转存。

错误码 · MomoAI算力超市