Query a video task ​

Check the status and result of a video generation task.

Endpoint ​

Endpoint: GET https://api-ai.xiaoku.ai/doubao/v3/contents/generations/tasks/{task_id}

Request parameters ​

ParameterDescriptionRequired
task_idVideo task IDYes

Example ​

bash
curl -X GET \
  https://api-ai.xiaoku.ai/doubao/v3/contents/generations/tasks/{task_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response fields ​

FieldDescription
idTask ID
modelModel used
statusTask status
contentVideo content
content.video_urlDownload URL
usageToken usage
created_atCreated at
updated_atUpdated at
seedRandom seed
resolutionResolution
ratioAspect ratio
durationDuration
framespersecondFrame rate
service_tierService tier
execution_expires_afterTask expiry
generate_audioWhether the video includes audio

Status values ​

StatusMeaning
queuedWaiting in queue
runningRunning
succeededSucceeded
failedFailed
expiredTimed out

Response examples ​

Success ​

json
{
    "id": "doubao.cgt-20250101000000-0000",
    "model": "doubao-seedance-2-0-260128",
    "status": "succeeded",
    "content": {
        "video_url": "https://api-ai.xiaoku.ai/videos/xxx.mp4"
    },
    "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
    },
    "created_at": 1743414619,
    "updated_at": 1743414673,
    "seed": 10,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "service_tier": "default",
    "execution_expires_after": 172800,
    "generate_audio": true,
    "draft": false
}

In progress ​

json
{
    "id": "doubao.cgt-20250101000000-0000",
    "model": "doubao-seedance-2-0-260128",
    "status": "running",
    "created_at": 1743414619,
    "updated_at": 1743414620
}

Notes ​

  1. Video generation is asynchronous. Poll until status is succeeded or failed.
  2. Download URLs expire. Save the file promptly.
  3. The default task timeout is 172800 seconds (48 hours).
  4. Poll every 2–5 seconds.