03-Query-Video-Generation-Task-List
Query Video Generation Task List
Version: v1.0.0 | Last Updated: 2026-06-11 This platform fully supports the Doubao Seedance series video generation API. Requests and responses are transparently proxied, and all parameter semantics remain consistent with the official API.
GET https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasksQuery Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page_num | integer | No | 1 | Page number for pagination. Range: [1, 500]. |
page_size | integer | No | 20 | Number of tasks per page. Range: [1, 500]. |
filter.status | string | No | - | Filter tasks by status. Values: "queued", "running", "succeeded", "failed", "cancelled", "expired". Only tasks matching the specified status are returned. |
filter.task_ids | string | No | - | Filter by specific task IDs. This is a repeated query parameter -- specify multiple task IDs by repeating the parameter (e.g., filter.task_ids=id1&filter.task_ids=id2). |
filter.model | string | No | - | Filter tasks by model Endpoint ID (e.g., "seedance-2.0", "seedance-1.5-pro"). Only tasks created with the specified model are returned. |
filter.service_tier | string | No | - | Filter tasks by service tier. Values: "default", "flex". |
Request Example
Basic Pagination
Filtered by Status and Model
Filtered by Multiple Task IDs
Response Fields
| Field | Type | Description |
|---|---|---|
items | object[] | Array of task objects. Each object has the same structure as the single task query response, including id, model, status, content, usage, and all other task fields. |
total | integer | Total number of tasks matching the filter criteria (across all pages). |
Response Example
{
"items": [
{
"id": "task_abc123def456",
"model": "seedance-2.0",
"status": "succeeded",
"created_at": 1718100000,
"updated_at": 1718100120,
"content": {
"video_url": "https://cdn.example.com/generated/video_abc123.mp4"
},
"seed": 42,
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"framespersecond": 25,
"generate_audio": true,
"service_tier": "default",
"execution_expires_after": 172800,
"usage": {
"completion_tokens": 1500,
"total_tokens": 1500
}
},
{
"id": "task_xyz789",
"model": "seedance-1.5-pro",
"status": "running",
"created_at": 1718100300,
"updated_at": 1718100350,
"resolution": "1080p",
"ratio": "9:16",
"duration": 10,
"generate_audio": true,
"draft": false,
"service_tier": "default",
"execution_expires_after": 172800
}
],
"total": 47
}Note: Video download URLs in the itemsarray follow the same 24-hour validity rule as the single task query. Re-query individual tasks or the list to obtain fresh URLs if needed.