Hailuo 23 Image to Video

minimax_hailuo_23_i2v

Hailuo 2.3 I2V generates high-quality animated videos from images with enhanced resolution and motion quality.

Authentication

authorization `string` required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model `string` required

Model ID to use for the request.

Value: minimax_hailuo_23_i2v

first_frame_image `string` required

Input Image URL or Base64 Encoded (data:image/jpeg;base64,xxx Format).

prompt `string`

Video generation prompt. Supports camera motion: [Pan left], [Zoom in], etc. Max 2000 characters.

duration `integer`

Video Duration (Seconds).

Default: 6

resolution `string`

Video Resolution.

Default: 768P

prompt_optimizer `boolean`

Whether to Enable Prompt optimize.

Default: true

Error Codes

Code	Description
401	API key is missing or invalid
403	Insufficient balance or permission denied
429	Rate limit exceeded
500	Internal server error

Code Examples

curl --location 'https://cloud.vtrix.ai/model/v1/generation' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
  "model": "minimax_hailuo_23_i2v",
  "input": [
    {
      "params": {
        "first_frame_image": "example_first_frame_image",
        "prompt": "example_prompt",
        "duration": 6,
        "resolution": "768P",
        "prompt_optimizer": true
      }
    }
  ]
}'

Response Format

{
  "type": "video",
  "url": "Generated content URL",
  "jobId": "Job identifier"
}

Authentication

authorization string required

Parameters

model string required

first_frame_image string required

prompt string

duration integer

resolution string

prompt_optimizer boolean