Query Video Generation Task

Endpoint

GET /v1/videos/{task_id}

Header Parameters

Name	Type	Required	Description	Example
Authorization	string	No		Bearer {your_token}

Path Parameters

Name	Type	Required	Description	Example
task_id	string	Yes

Response Fields

Field	Type	Required	Title	Description
id	string	Yes	task ID
model	string	Yes	Model name
object	string	Yes	Task type
prompt	string	Yes	prompt
status	string	Yes	Status	queued:, in_progress: generation, completed: completed, failed: Failed
duration	string	Yes	task
metadata	string	Yes	//
progress	string	Yes
video_url	string	Yes	video URL
created_at	string	Yes	Created time
thumbnail_url	string	Yes

Response Examples

Example 1

{
  "id": "gen_xxxxxxx",
  "model": "sora2",
  "object": "video.generation.job",
  "prompt": "xxxxxxxxxxxxxx",
  "status": "completed",
  "duration": 89,
  "metadata": {
    "total_time": 89.550817778,
    "predict_time": 89.537048777
  },
  "progress": 100,
  "video_url": "https://xx.xxxxxx.cn/xxxx/xxxxxxxxxxxxxxxxxxxxxxxx.mp4",
  "created_at": 1770405484,
  "thumbnail_url": null
}