API字节跳动Seedance 系列模型
错误码
视频 API 的统一错误结构。
错误结构
{
"error": {
"code": "InvalidParameter",
"message": "model is required"
}
}当前只返回 code 与 message；不保证包含兼容 param 或 type 字段。
常见错误
| code | 典型 HTTP | 说明 |
|---|---|---|
InvalidParameter | 400 | 请求体或参数无效 |
InvalidActionOrVersion | 400 | 素材 Action 或 Version 不受支持 |
AuthenticationError | 401 | 令牌缺失或无效 |
AccessDenied | 403 | 分组/模型权限不足，或使用了 auto 分组 |
NotFound | 404 | 模型、任务或素材不存在 |
AmbiguousServiceConfiguration | 409 | 同一分组/模型匹配到多个服务配置，请联系支持 |
TaskNotCancellable | 409 | 任务运行中或缺少服务端任务 ID |
CancelUnconfirmed | 409 | 服务端未确认取消 |
RefundPending | 409 | 退款尚未完成 |
SubmissionUncertain | 409 | 提交结果不确定，使用返回的 task_id 查询确认 |
TaskResponseUnavailable | 502 | 任务响应暂不可用 |
TaskServiceUnavailable | 502 | 服务端请求失败 |
ServiceUnavailable | 503 | 任务服务暂不可用 |
NotImplemented | 501 | 当前模型服务/配置不支持该操作 |
RateLimitExceeded | 429 | 请求过于频繁 |
处理建议
401/403：检查令牌、分组和模型权限。404：确认任务属于当前令牌与分组，且未被删除。409 SubmissionUncertain：不要重复提交；先用task_id查询。501：该能力未对当前模型服务开放，不要重试。503/502：可稍后重试查询；创建任务前请确认幂等。