APIByteDanceSeedance series
Get task
Query a task by id or task_id.
Request
GET /ai/api/v3/contents/generations/tasks/{id}
Authorization: Bearer <TUIWO_API_TOKEN>{id} can be the id (compatible task ID) or task_id (platform task ID) from the create response.
Response
{
"id": "cgt-xxxxxxxx",
"task_id": "task_xxxxxxxx",
"model": "<seedance-model-id>",
"status": "succeeded",
"content": {
"video_url": "https://..."
},
"usage": {},
"created_at": 1760000000,
"updated_at": 1760000100
}The full full compatible field set is returned; service_* fields are never returned.
Status
queued, running, succeeded, failed, cancelled, expired.
Some tasks are updated by platform polling, so results may lag. service_tier is returned but cannot be used as a filter.
Errors
| HTTP | code | Description |
|---|---|---|
| 401 | AuthenticationError | Invalid token |
| 404 | NotFound | Task missing, outside the current user/group or deleted |
| 502 | TaskResponseUnavailable | Task response unavailable |
Media URLs
content.video_url and content.last_frame_url: directly reachable media URLs are returned as-is; other media URLs use the platform-signed proxy valid for about 24 hours. Query again for a fresh URL after expiry.