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/standard/image-to-video",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "duration": 6,
    "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 Image to Video

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

​

Available Models

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

​

Duration Options

• 6, 10 seconds - Set duration as an integer. Optional. Default: 6 seconds.

​

Key Features

• Generate video from image input.
• Accepts exactly 1 image in image_urls.
• Optionally supply an ending frame with end_image_url.
• Accepts 512P or 768P resolution; defaults to 768P.

​

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. Length: 1-1,500 characters.
• 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. Standard requires 768P when an ending frame is supplied.

​

Resolution

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

​

Prompt Optimizer

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

​

Pricing

512P: 3 credits/second, 18 credits ($0.09) for 6 seconds or 30 credits ($0.15) for 10 seconds. 768P: 7 credits/second, 42 credits ($0.21) for 6 seconds or 70 credits ($0.35) for 10 seconds. 1 credit = $0.005. Credits are deducted on submission and refunded if the task fails.