​
Query Video Generation Task

The Doubao video query task API allows you to query the current status, progress, and final results of a video generation task.

​
Endpoint

GET /v1/video/generations/{id}

​
Authentication

All requests require a Bearer token in the Authorization header: 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

ParameterTypeRequiredDescription
idstringYesThe unique identifier of the video generation task

​
Request Example

curl -X GET "https://api.example.com/v1/video/generations/cgt-20240101-abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response Parameters

ParameterTypeDescription
modelstringModel name and version used for the task
statusstringTask status: submitted, processing, succeeded, failed
created_atstringTask creation timestamp
updated_atstringTask update timestamp
contentobjectTask result content
content.video_urlstringGenerated video URL
usageobjectUsage information
usage.completion_tokensintegerCompletion token count
usage.total_tokensintegerTotal token count
errorobjectError information (only returned on failure)
error.codestringError code
error.messagestringError description

​
Response Examples

​
Success Example

{
  "model": "doubao-seedance-1-0-lite-i2v-250428",
  "status": "succeeded",
  "created_at": "1718049470",
  "updated_at": "1718049470",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "usage": {
    "completion_tokens": 35800,
    "total_tokens": 35800
  }
}

​
Failure Example

{
  "id": "cgt-20240101-abc123",
  "model": "doubao-seedance-1-0-lite-i2v-250428",
  "status": "failed",
  "error": {
    "code": "OutputVideoSensitiveContentDetected",
    "message": "The request failed because the output video may contain sensitive information."
  },
  "created_at": "1718049470",
  "updated_at": "1718049470"
}

​
Status Description

StatusDescription
submittedTask has been submitted
processingTask is being processed
succeededTask completed successfully
failedTask failed