Skip to main content
POST
/
v3
/
async
/
minimax-hailuo-2.3-i2v
Minimax Hailuo 2.3 Image-to-Video
curl --request POST \
  --url https://api.myrouter.ai/v3/async/minimax-hailuo-2.3-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "enable_prompt_expansion": true,
  "fast_pretreatment": true
}
'
{
  "task_id": "<string>"
}
Minimax Hailuo 2.3 is a newly upgraded video generation model with improved performance in body movements, physical effects, and instruction comprehension and execution.
This is an async API that only returns the task_id of the async task. You should use the task_id to call the Get Async Task Result API to retrieve the generated result.

​
Request Headers

​
Content-Type
string
required
Enum: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API Key}}.

​
Request Body

​
prompt
string
required
The prompt text that guides the generation.Range: 1 <= x <= 2000.Supports 15 camera movement instructions:
  • Horizontal pan: [Pan Left], [Pan Right]
  • Horizontal rotate: [Rotate Left], [Rotate Right]
  • Push/Pull: [Push In], [Pull Out]
  • Vertical move: [Rise], [Descend]
  • Vertical tilt: [Tilt Up], [Tilt Down]
  • Zoom: [Zoom In], [Zoom Out]
  • Other: [Shake], [Follow], [Static]
Usage rules:
  • Combined camera movements: Multiple instructions within the same [] will take effect simultaneously, e.g. [Rotate Left, Rise]. It is recommended to combine no more than 3
  • Sequential camera movements: Instructions appearing in sequence in the prompt will take effect one after another, e.g. ”…[Push In], then…[Pull Out]”
  • Natural language: Camera movements can also be described in natural language, but using standard instructions produces more accurate results
​
image
string
required
The image used for video generation. Supports public URLs or Base64 encoding (e.g. data:image/jpeg;base64,...).
​
duration
integer
Duration of the generated video (in seconds). Default: 6
Possible values: 6, 10
​
resolution
string
Resolution of the generated video. Default: 768P
  • 6-second videos support: 768P, 1080P
  • 10-second videos only support: 768P
​
enable_prompt_expansion
boolean
Whether to enable prompt optimization.Default: true.
​
fast_pretreatment
boolean
default:false
Whether to reduce the time spent on prompt optimization.Default: false.

​
Response

​
task_id
string
required
The task_id of the async task. Use the task_id to call the Get Async Task Result API to retrieve the generated result.