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.
• Do not send duration; the current PoYo Pro handler rejects this field.

​

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.

• Resolution is forwarded to PoYo as supplied; no fixed output duration or 1080P output is asserted by this contract.

​

Prompt

• prompt: Required. Describe the scene and desired motion. The current PoYo Pro handler has no explicit prompt length limit.
• 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 current Pro handler accepts an ending frame with either resolution.

​

Prompt Optimizer

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

​

Pricing

65 credits ($0.325) per generation, for either resolution. 1 credit = $0.005. Credits are deducted on submission and refunded if the task fails.