Video & Materials
List Tasks (Volc Compatible)
List recent Seedance compatibility tasks for the current organization.
Overview
List recent compatibility tasks in the authenticated Workspace using a TokenLab Bearer API key. Without filter.task_ids, results cover recent tasks from the past seven days; supplying exact IDs queries those tasks directly.
See also Seedance 2.0 Video Models and Video Generation.
Listing And Filters
page_num: default1, integer from1to500.page_size: default20, integer from1to500.filter.status:queued,running,succeeded,failed,cancelled,expired.filter.task_ids: Repeat this parameter for multiple exact task IDs; do not join them with commas.filter.model: Model identifier.filter.service_tier:default,flex.
The response contains items and total for the filtered results. Each item uses the get-task response shape. Use the get endpoint to refresh a known task’s status.
Example
curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl "https://api.tokenlab.sh/api/v3/contents/generations/tasks?filter.task_ids=cgt-20260102030405-a1b2c" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"curl -X GET "https://example.com/api/v3/contents/generations/tasks"{ "items": [ { "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0 } ], "total": 0}Authorization
BearerAuth API Key authentication. Create or manage API keys in Dashboard > API > API Keys.
In: header
Query Parameters
Page number.
1 <= value <= 5001Page size.
1 <= value <= 50020Filter by task status.
Value in
- "queued"
- "running"
- "succeeded"
- "failed"
- "cancelled"
- "expired"
Exact task IDs. Repeat filter.task_ids for multiple IDs.
Filter by model identifier.
Filter by service tier.
Response
application/json
application/json
application/json
application/json