错误处理
先检查 HTTP 状态,再读取响应正文。任务查询 HTTP 成功时,也要检查任务 status 是否为 failed。
HTTP 状态
以下状态已出现在 Seedance 的 ApiPost 接口定义中。
| 状态 | 含义 | 建议处理 |
|---|---|---|
400 / 422 | 请求或参数不合法 | 按错误字段修正输入 |
401 | 未通过认证 | 检查密钥与 Bearer 请求头 |
403 | 无权限 | 核对账号与模型权限 |
404 | 资源或接口不存在 | 核对路径及平台任务 ID |
409 | 资源冲突 | 检查原请求状态,避免盲目重复提交 |
413 | 请求内容过大 | 缩小请求体或素材 |
429 | 请求受限 | 降低并发并进行有上限的退避 |
500 / 502 / 503 | 服务异常 | 保留脱敏错误,稍后重试或联系支持 |
各接口覆盖的状态并不完全相同,以具体定义为准。
两类错误结构
原生协议错误包含 error.code、error.message、error.type,参数错误可能包含 error.param。
部分平台边界错误使用 code、msg、data、request_id、time。不要假定所有错误都具有相同结构。
提供排查信息
保留请求时间、HTTP 状态、平台任务 ID、请求 ID(如有)和脱敏错误消息。不要发送 API Key、Authorization 请求头或包含签名的完整下载链接。

