跳转到正文
阅读设置
开发支持

错误处理 ​

先检查 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 请求头或包含签名的完整下载链接。