Get Video Generation Task Status

Query Hailuo video task status by task_id: poll progress, state, and the final video download URL, with response fields, cURL example, and status codes.

(Hailuo Video)

Query the real-time status, progress, and final video download link of a video generation task by task ID.

Basics

Endpoint: GET /v1/video/generations/{task_id}
Authentication: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
Content type: application/json

Request Parameters (Path)

Parameter	Type	Required	Description
task_id	`string`	Yes	The task ID returned when the generation task was submitted.

Response

Status code: 200 OK

Field	Type	Description
code	`string`	Business status code ("200" means the request succeeded).
message	`string`	Response message.
data	`object`	Task detail object.
├─ status	`string`	Task status: `processing`, `success`, `failed`.
├─ progress	`string`	Generation progress percentage (e.g. "50").
├─ result_url	`string`	Download link once the video is generated successfully.
├─ fail_reason	`string`	Failure reason if the task failed.
├─ submit_time	`integer`	Unix timestamp when the task was submitted.
├─ finish_time	`integer`	Unix timestamp when the task finished.
└─ video_width	`integer`	Width of the generated video in pixels.
└─ video_height	`integer`	Height of the generated video in pixels.

Request Example (cURL)

curl -X GET "https://api.your-server.com/v1/video/generations/task_pNzpa5Aw21zihhdYrACj6Jy0ZVW76BEe" \
 -H "Authorization: Bearer $YOUR_API_KEY"

Response Example (Success)

{
  "code": "200",
  "message": "success",
  "data": {
    "task_id": "task_pNzpa5Aw21zihhdYrACj6Jy0ZVW76BEe",
    "status": "success",
    "progress": "100",
    "result_url": "https://cdn.example.com/generated_video.mp4",
    "video_width": 1280,
    "video_height": 720,
    "submit_time": 1774595255,
    "finish_time": 1774595315
  }
}

The current status of the task. Possible values:

Preparing – being prepared Queueing – in the queue Processing – generating Success – succeeded Fail – failed Available options: Preparing, Queueing, Processing, Success, Fail