Get Video Generation Task Status

Query the progress and result of a video generation task. Pairs with Create Video Generation Task (the generic task format).

NOTE

The Sora format (/v1/videos) responds differently: lowercase status values, and the video is downloaded from the /content endpoint once done. The Kling and Jimeng native formats have their own query endpoints — see those pages; their response structure is identical to this endpoint's. The Doubao / Seedance and MiniMax-H3 channels use this endpoint directly (parameter differences on their pages).

Endpoint

GET /v1/video/generations/{task_id}

Authentication

Send a Bearer token in the request header:

Authorization: Bearer sk-your-token

Path Parameters

ParameterTypeRequiredNotes
task_idstringYesTask ID returned by the create endpoint

Response Body

The query response is a unified task JSON:

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://xxxx/video.mp4",
    "fail_reason": ""
  }
}
data fieldNotes
task_idTask ID
statusStatus flow: NOT_START (submitted, pending) → QUEUED / SUBMITTED (queued, submitted) → IN_PROGRESS (generating) → SUCCESS or FAILURE
progressProgress percentage string, e.g. "50%"
result_urlDirect video download link after success; download and store it promptly (product links expire after about 1 hour)
fail_reasonFailure reason

A nonexistent task returns 400:

{
  "code": "task_not_exist",
  "message": "task not exist",
  "data": null
}

Polling Example

Poll once every 10 seconds or so; once SUCCESS, download the video from the data.result_url direct link.

cURL
Python
Node.js
curl https://api-model.shuntianchuang.cn/v1/video/generations/task_xxxxxxxx \
  -H "Authorization: Bearer sk-your-token"

Billing is settled on actual usage at task completion (auto-refunded on failure).