curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax/hailuo-02/pro/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "resolution": "768P"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

Hailuo 02 Pro Image to Video

Animate still images with Hailuo 02 Pro, with text guidance, prompt refinement, and an optional closing frame to shape the shot.

​

Available Models

• minimax/hailuo-02/pro/image-to-video - Generate video from image input.

​

Output Options

• resolution: Optional. Accepted values: 512P, 768P. Default: 768P.

​

Key Features

• Generate video from image input.
• Accepts exactly 1 image in image_urls.
• Optionally supply an ending frame with end_image_url.

​

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

​

Prompt

• prompt: Required. Describe the scene and desired motion. No maximum prompt length is specified.
• Whitespace is trimmed before validation; the result must not be blank.

​

Image URLs

• image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL.

​

End Image URL

• end_image_url: Optional. Provide the ending frame URL. Use a publicly accessible HTTP(S) URL. Requires a starting image in image_urls. The ending frame is supported at both resolutions.

​

Prompt Optimizer

• prompt_optimizer: Optional. Control automatic prompt optimization. Use true or false.

​

Billing Factors

Billed per generation using the Pro model tier. Both supported resolutions use the same rate. Credits are deducted on submission and refunded if the task fails.