Poll video status

curl "https://mvp.tryunsora.com/api/v1/video/status/GENERATION_ID" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "model": "<string>",
    "outputUrl": "<string>",
    "thumbnailUrl": "<string>",
    "error": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

GET

video

status

{id}

curl "https://mvp.tryunsora.com/api/v1/video/status/GENERATION_ID" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "<string>",
    "status": "<string>",
    "model": "<string>",
    "outputUrl": "<string>",
    "thumbnailUrl": "<string>",
    "error": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

Poll a video job created via Create video. Use the id from the create response. GET /video/status/{id} — same pattern as image (/image/status/{id}). Poll every few seconds until status is COMPLETED or FAILED.

Path parameter

string

required

Generation id from POST /videos/create (generation.id).

Response

{
  "success": true,
  "data": {
    "id": "cm123abc",
    "model": "seedance_2.0",
    "status": "COMPLETED",
    "outputUrl": "https://files.tryunsora.com/....mp4",
    "thumbnailUrl": "https://files.tryunsora.com/....jpg",
    "error": null,
    "createdAt": "2026-06-02T12:00:00.000Z",
    "updatedAt": "2026-06-02T12:01:30.000Z",
    "completedAt": "2026-06-02T12:01:30.000Z"
  }
}

`status`	Meaning
`QUEUED`	Waiting to start
`PROCESSING`	Rendering
`COMPLETED`	`outputUrl` is ready
`FAILED`	See `error`

Example

curl "https://mvp.tryunsora.com/api/v1/video/status/GENERATION_ID" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY"

Errors

HTTP	When
`400`	Missing id
`401`	Invalid auth
`404`	User or generation not found
`500`	Server error

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Response

Status

success

boolean

required

data

object

required

Show child attributes

API documentation

CLI

User

Accounts

Posts

Generation status

Video generator

Image generator

Music generator

Voiceover

AI influencer

Thumbnail generator

Clipping

Uploads

Poll video status

Path parameter

Response

Example

Errors

Authorizations

Path Parameters

Response

​Path parameter

​Response

​Example

​Errors

Authorizations

Path Parameters

Response

Path parameter

Response

Example

Errors