TUIWOTUIWO
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

HTTPcodeDescription
401AuthenticationErrorInvalid token
404NotFoundTask missing, outside the current user/group or deleted
502TaskResponseUnavailableTask 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.