Error codes
Every error.code with its meaning, status and endpoints.
Error responses carry error.code and trace_id. Handle error.code, and quote trace_id when you contact us. Retry rules are on Idempotency and retries.
| Status | error.code | Meaning | What to do | Retry as is | Charged |
|---|---|---|---|---|---|
| 400 404 | asset_not_found | Asset is unknown, deleted or outside your teamCheck an asset, Create a video task | Check that the asset ID belongs to your team and still exists. | No | No |
| 400 | asset_unusable | Asset failed, has an unsuitable media type or lacks review approval for this requestCreate a video task | Use another asset, or one whose media type fits its role. | No | No |
| 400 | callback_target_not_verified | The address does not exactly match a verified, unrevoked and unexpired callback target owned by your teamCreate a video task | Register and verify the callback address in the console, or drop callback_url. | No | No |
| 400 | input_video_duration_exceeded | Combined video input exceeds the model's duration limitCreate a video task | Shorten the reference videos to the model's total limit. | No | No |
| 400 | invalid_request | Invalid request, including too many references for the modelRegister an asset, Check an asset, Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing | Fix the request as error.message describes, then send it again. | No | No |
| 400 | source_url_not_allowed | The source address does not meet the fetch policyRegister an asset | Use a public HTTPS address that the fetch policy accepts. | No | No |
| 400 | unsupported_capability | The available choices cannot satisfy the required capabilities togetherCreate a video task | Adjust the parameters named in error.details. | No | No |
| 401 | authentication_failed | The request could not be authenticatedRegister an asset, Check an asset, Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing | Check the API key after Authorization: Bearer. | No | No |
| 403 | permission_denied | Required permission is missingRegister an asset, Check an asset | Use an API key that has service.use permission. | No | No |
| 404 | task_not_found | The task is unknown or not visible to your teamRead a video task, Cancel a video task, Read task billing | Check that the task ID belongs to your team. | No | No |
| 409 | asset_not_ready | A referenced asset is still processingCreate a video task | Wait until the asset is active, then retry with the same key and body. | After the cause is fixed | No |
| 409 | idempotency_conflict | The same idempotency value was used for a different requestRegister an asset, Create a video task, Cancel a video task | Retry the original body with the same key; send a new request with a new key. | No | No |
| 409 410 | idempotency_replay_expired | The saved response can no longer be replayed exactlyRegister an asset, Create a video task, Cancel a video task | The original request was accepted: read it by ID instead of sending it again with a new key. | No | No |
| 409 | key_provisioning_incomplete | API key setup is incomplete; delete the key and create anotherCreate a video task | Delete this API key and create a new one. | No | No |
| 409 | task_not_cancellable | This finished task has no cancellation operation to refer toCancel a video task | The task has already finished; there is nothing to cancel. | No | No |
| 429 | asset_intake_rate_limit_exceeded | Asset intake capacity is limitedRegister an asset | Retry later with the same key. | After the cause is fixed | No |
| 429 | asset_storage_quota_exceeded | Asset storage allowance is insufficientRegister an asset, Create a video task | The storage allowance is used up; free space or contact us before registering more. | No | No |
| 429 | insufficient_balance | Balance is insufficient to accept the requestCreate a video task | Top up, then retry with the same key; error.details gives the reservation needed. | After the cause is fixed | No |
| 429 | rate_limited | The request rate is limitedCreate a video task, List team tasks, Read a video task, Cancel a video task, Read task billing | Wait Retry-After seconds, then retry with the same key. | After the cause is fixed | No |
| 500 | internal_error | The service could not complete the requestCreate a video task, List team tasks, Read a video task, Cancel a video task, Read task billing | Retry with the same Idempotency-Key and body. | Yes, same key | No; a retry is never charged twice |
| 503 | dependency_unavailable | The service is temporarily unavailable and the outcome is unknownRegister an asset, Check an asset, Create a video task, List team tasks, Read a video task, Cancel a video task, Read task billing | The outcome is unknown: retry with the same key and body. | Yes, same key | No; a retry is never charged twice |
| 503 | funding_intake_closed | New intake is closedCreate a video task | New intake is closed for now; try later. Exact replays of accepted requests still return their response. | After the cause is fixed | No |
No matching error code.