curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-max-image-to-video",
  "prompt": "Pull focus from the ramen bowl in the foreground to the people in the background. More steam rises naturally from the bowl as the camera gently pushes forward; preserve the characters and restaurant setting.",
  "image_start": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png",
  "duration": 5,
  "quality": "768p"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-max-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-max-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax H3

Minimax H3 Max Image-to-Video

Provide at least one of image_start or image_end; first-frame-only, last-frame-only, and first-and-last-frame modes are supported
Output duration: 5–15 seconds; resolution 480p or 768p (default)
The model automatically adapts the output aspect ratio to the input image; do not send aspect_ratio
Asynchronous processing; use the returned task ID to query status
Generated video URLs are valid for 24 hours; save them promptly

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-max-image-to-video",
  "prompt": "Pull focus from the ramen bowl in the foreground to the people in the background. More steam rises naturally from the bowl as the camera gently pushes forward; preserve the characters and restaurant setting.",
  "image_start": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png",
  "duration": 5,
  "quality": "768p"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-max-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 5
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: minimax-h3-max-image-to-video",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

##All endpoints require Bearer Token authentication##

Get API Key:

Visit the API Key Management Page to obtain your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:minimax-h3-max-image-to-video

required

Video generation model name

Available options:

minimax-h3-max-image-to-video

Example:

"minimax-h3-max-image-to-video"

prompt

string

required

Describe how the input image should move, how the camera should change, and the desired video content.

Prompt requirements:

Required and cannot be empty
Chinese and English are supported
Maximum length 7000 characters (Chinese and English are both counted by character)
The model may ignore some details in an overly long prompt

Input restrictions:

Use image_start and/or image_end to provide keyframes
video_urls, and audio_urls are not supported; supplying them returns a parameter error

Required string length: 1 - 7000

Example:

"Pull focus from the ramen bowl in the foreground to the people in the background. More steam rises naturally from the bowl as the camera gently pushes forward; preserve the characters and restaurant setting."

image_start

string<uri>

HTTP(S) URL of the first-frame image.

Combination rules:

Provide at least one of image_start and image_end
image_start only: first-frame image-to-video
Both fields: first-and-last-frame image-to-video
At most 1 first frame; this field accepts one URL

Image requirements:

Formats: JPG, JPEG, PNG, WEBP, HEIC, HEIF
File size: no more than 30MB
Width and height: each from 256 to 5760 px
Aspect ratio (width/height): 0.4–2.5
The URL must use HTTP(S) and be directly accessible by the service
The complete JSON request body must not exceed 64MB; Base64 and mm_file:// inputs are not accepted

Example:

"https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"

image_end

string<uri>

HTTP(S) URL of the last-frame image.

Combination rules:

Provide at least one of image_end and image_start
image_end only: the model generates natural motion that ends on this frame
Both fields: first-and-last-frame image-to-video
At most 1 last frame; this field accepts one URL

Image requirements:

Formats: JPG, JPEG, PNG, WEBP, HEIC, HEIF
File size: no more than 30MB
Width and height: each from 256 to 5760 px
Aspect ratio (width/height): 0.4–2.5
The URL must use HTTP(S) and be directly accessible by the service
The complete JSON request body must not exceed 64MB; Base64 and mm_file:// inputs are not accepted

Example:

"https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85"

duration

integer

default:5

Output video duration in seconds. Defaults to 5 seconds.

Value restrictions:

Only integers from 5 through 15, inclusive, are supported
Decimals, numeric strings, auto, and -1 are not supported
Output duration directly affects billing

Required range: 5 <= x <= 15

Example:

5

quality

enum<string>

default:768p

Output video resolution. Defaults to 768p.

Available values:

480p
768p: default

Notes:

Omitting this parameter produces 768p output
Output bitrate, frame rate, video codec, and audio codec are selected by the platform and are not configurable

Available options:

480p,

768p

Example:

"768p"

callback_url

string<uri>

HTTPS callback URL for task completion

Callback timing:

Triggered when the task is completed or failed
Sent after billing confirmation is complete

Security restrictions:

Only HTTPS protocol is supported
Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback mechanism:

Timeout: 10 seconds
Up to 3 retries after failure (at 1/2/4 seconds after failure respectively)
Callback response body format is consistent with the task query endpoint response format
A 2xx status code is considered successful; other status codes trigger retries

Pattern: ^https://

Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video generation task created successfully

created

integer

Task creation timestamp

Example:

1761313744

string

Task ID

Example:

"task-unified-1774857405-abc123"

model

string

Actual model name used

Example:

"minimax-h3-max-image-to-video"

object

enum<string>

Specific type of the task

Available options:

video.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Video task details

Show child attributes

type

enum<string>

Output type of the task

Available options:

text,

image,

audio,

video

Example:

"video"

usage

object

Usage and billing information

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Minimax H3 Max Image-to-Video

Authorizations

Body

Response