GEgenaipro
H3 Video

Get Task Status

Changed on

Poll the status of a /v2/hailuo task (any creation endpoint of this group; Sunburst / Flare image tasks are also readable here).

Status values

StatusDescription
processingTask is being processed
completedDone — file_urls contains the generated files. If some outputs failed, failed_slots lists them (refunded)
failedError — see error. Credits are automatically refunded

Rate limit: 120 requests/minute per account, across all tasks. Prefer callback_url, the hailuo_task_updated WebSocket event, or GET /v2/hailuo/histories (see H3 Video → Getting results).

get/v2/hailuo/tasks/{id}

Request

Path parameters

idstring required

Task ID received from a creation endpoint

Response

Task status

idstring

Task ID (use for GET /v2/hailuo/tasks/{id})

promptstring

The prompt used for generation (for Boost HD, the source task's prompt)

file_urlsstring[]

URLs of the generated files (empty while processing). Public; deleted about 90 days after creation (then 404) — download them yourself.

status'processing' | 'completed' | 'failed'

Task status

errorstring

Error message — present only when status is failed

task_typestring

text_to_video, frames_to_video, reference_to_video or upscale_video (image tasks: create_image)

aspect_ratiostring

Aspect ratio of the task — Auto for frames-to-video (follows the start image)

modelstring

Model and options of the task. Video: <model>_<resolution>_<duration>s (e.g. h3_768p_10s, h3_max_480p_5s); Boost HD: upscale_<resolution> (e.g. upscale_1440p).

number_of_outputsinteger

Number of videos (or images) requested

created_atstring date-time

Timestamp when the task was created

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "A drone flying over mountains at sunrise",
  "file_urls": [],
  "task_type": "text_to_video",
  "aspect_ratio": "16:9",
  "model": "h3_768p_10s",
  "number_of_outputs": 1
}

Changes