Hailuo 2.3 Pro Image to Video

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

{
  "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>"
}

Turn a starting image into a 1080p video with Hailuo 2.3 Pro, using text and optional prompt refinement to guide the motion.

​

Models

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

​

Features

• Generate video from image input.
• Use start_image_url to supply the starting frame.
• This model ID fixes the output resolution to 1080p.

​

Duration Options

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

​

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. JSON types are validated without converting strings to numbers or booleans; prompt must be a string and fractional durations are rejected. 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-5,000 characters.
• The value must not be blank when supplied.

​

Resolution

• resolution: Optional. Accepted values: 1080p. Default: 1080p.

​

Start Image URL

• start_image_url: Required. Provide the starting frame URL. Use a publicly accessible HTTP(S) URL.

​

Prompt Optimizer

• prompt_optimizer: Optional. Control automatic prompt optimization. Use true or false. No default is specified; omit this field when unused.

​

Billing Factors

Billed per video using the Pro model tier. This endpoint fixes output resolution to 1080p and duration to 6 seconds. Prompt optimization (prompt_optimizer) does not change the charge. Credits are deducted on submission and refunded if the task fails.