APIByteDanceSeedance series
Errors
Unified error shape for the video API.
Error shape
{
"error": {
"code": "InvalidParameter",
"message": "model is required"
}
}Only code and message are guaranteed; compatible param and type fields are not currently included.
Common errors
| code | Typical HTTP | Description |
|---|---|---|
InvalidParameter | 400 | Invalid body or parameter |
InvalidActionOrVersion | 400 | Unsupported asset action or version |
AuthenticationError | 401 | Missing or invalid token |
AccessDenied | 403 | Insufficient group/model access or auto group |
NotFound | 404 | Model, task or asset not found |
AmbiguousServiceConfiguration | 409 | Multiple service configurations match; contact support |
TaskNotCancellable | 409 | Task running or missing service task ID |
CancelUnconfirmed | 409 | Service did not confirm cancellation |
RefundPending | 409 | Refund not completed |
SubmissionUncertain | 409 | Submission uncertain; query with the returned task_id |
TaskResponseUnavailable | 502 | Task response unavailable |
TaskServiceUnavailable | 502 | Service request failed |
ServiceUnavailable | 503 | Task service unavailable |
NotImplemented | 501 | Service/configuration does not support the operation |
RateLimitExceeded | 429 | Too many requests |
Handling
401/403: check the token, group and model access.404: confirm the task belongs to the current token/group and was not deleted.409 SubmissionUncertain: do not resubmit; query withtask_id.501: the capability is not open for this service; do not retry.503/502: retry queries later; confirm idempotency before creating again.