Theme
Seedance task query
After submitting a Seedance 2.0 task, query status, progress, and results by task_id.
http
GET /v1/video/generations/{task_id}Replace {task_id} in the path with the task ID returned by Video generation. When complete, the result video URL is at data.data.content.video_url.
Headers
| Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | Request authentication. Use a Bearer Token, for example: |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | Path parameter. Video generation task ID, same as task_id returned by the create endpoint |
Request example
bash
curl https://octopusx.ai/v1/video/generations/cgt-20260412163502-x8k2m \
-H "Authorization: Bearer <token>"Response example
json
{
"code": "success",
"data": {
"task_id": "task_xxxxx",
"status": "IN_PROGRESS",
"progress": "50%",
"submit_time": 1775908082,
"start_time": 1775908086,
"finish_time": 0,
"data": {
"status": "processing",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"content": {}
}
}
}json
{
"code": "success",
"data": {
"task_id": "task_xxxx",
"status": "SUCCESS",
"progress": "100%",
"submit_time": 1775908082,
"start_time": 1775908086,
"finish_time": 1775908321,
"data": {
"status": "succeeded",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"content": {
"video_url": "https://example.com/output.mp4"
},
"usage": {
"completion_tokens": 108900,
"total_tokens": 108900
}
}
}
}json
{
"code": "success",
"data": {
"task_id": "task_xxxx",
"status": "FAILURE",
"progress": "100%",
"submit_time": 1775908082,
"start_time": 1775908086,
"finish_time": 1775908200,
"fail_reason": "Content safety check failed",
"data": {
"status": "failed",
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"content": {}
}
}
}Response fields
| Name | Type | Description |
|---|---|---|
| string | Business status code. on success | |
| string | Task ID | |
| string | Task status: , , | |
| string | Progress (percentage string, e.g. ) | |
| integer | Submit timestamp | |
| integer | Start timestamp | |
| integer | Finish timestamp | |
| string | Failure reason (present on failure) | |
| string | Internal status: , , | |
| string | Result video URL when complete | |
| object | Token usage (present on success) |