Error Codes

HTTP Status Codes

Status	Meaning
`202`	Job accepted (create video)
`200`	OK
`400`	Bad request — invalid parameters
`401`	Missing or invalid Bearer token
`404`	Job not found or belongs to another team
`429`	Monthly quota exceeded
`504`	Timeout (sync endpoint only)

All errors follow this structure:

{
  "error": {
    "code": "invalid_parameters",
    "fields": [
      { "path": "model", "message": "model not allowed" }
    ]
  }
}

Code	Trigger
`unauthorized`	Missing or invalid token
`invalid_parameters`	Bad request body — see `error.fields` for which field failed
`not_found`	Job ID doesn’t exist or belongs to another team
`quota_exceeded`	Monthly budget limit reached
`generation_failed`	AI provider failed to generate the video
`timeout`	Job exceeded the maximum processing time

This means the AI provider rejected or failed the job — the error is not billable. Common causes:

Retry with a modified prompt or a different image URL.