curl "https://mvp.tryunsora.com/api/v1/video/status/GENERATION_ID" \
-H "Authorization: Bearer uns_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>"
}Generation status
Poll video status
Poll a video generation job until it completes — returns the latest status and the finished video URL once rendering is done.
GET
/
video
/
status
/
{id}
curl "https://mvp.tryunsora.com/api/v1/video/status/GENERATION_ID" \
-H "Authorization: Bearer uns_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_YOUR_API_KEY"
Errors
| HTTP | When |
|---|---|
400 | Missing id |
401 | Invalid auth |
404 | User or generation not found |
500 | Server error |