Minimax H3 Image-to-Video 图生视频

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-image-to-video",
  "prompt": "焦点从前景的拉面碗缓缓转移到背景人物，热气持续从碗中升起并随空气自然飘散。镜头轻微前推，保持人物身份和餐厅环境一致。",
  "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": "2k",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "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-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"
  }
}

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-image-to-video",
  "prompt": "焦点从前景的拉面碗缓缓转移到背景人物，热气持续从碗中升起并随空气自然飘散。镜头轻微前推，保持人物身份和餐厅环境一致。",
  "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": "2k",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "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-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"
  }
}

授权

Authorization

string

header

必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key：

访问 API Key 管理页面获取您的 API Key

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

默认值:minimax-h3-image-to-video

必填

视频生成模型名称

可用选项:

minimax-h3-image-to-video

示例:

"minimax-h3-image-to-video"

prompt

string

必填

描述输入图片如何运动、镜头如何变化以及期望生成的视频内容。

提示词要求：

必填且不能为空
支持中文和英文
建议中文不超过 500 字、英文不超过 1000 词；提示词过长时，模型可能忽略部分细节

输入限制：

本模型使用 image_start 和/或 image_end 接收首尾帧
不支持 image_urls、video_urls、audio_urls；传入这些字段会返回参数错误

Minimum string length: 1

示例:

"焦点从前景的拉面碗缓缓转移到背景人物，热气持续从碗中升起并自然飘散。镜头轻微前推，保持人物身份和餐厅环境一致。"

image_start

string<uri>

首帧图片的 HTTP(S) URL。

组合规则：

image_start 与 image_end 至少传入一个
仅传 image_start：首帧图生视频
同时传入两者：首尾帧图生视频
首帧最多 1 张，本字段为单个 URL

图片要求：

支持格式：JPG、JPEG、PNG、WEBP、HEIC、HEIF
单张大小：不超过 30MB
图片宽度和高度：均为 256–5760 px
宽高比（宽/高）：0.4–2.5
URL 必须使用 HTTP(S)，且可由服务端直接访问
整个 JSON 请求体大小不超过 64MB；不接受 Base64 或 mm_file:// 输入

示例:

"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。

组合规则：

image_end 与 image_start 至少传入一个
仅传 image_end：尾帧图生视频，模型生成自然运动并在该画面结束
同时传入两者：首尾帧图生视频
尾帧最多 1 张，本字段为单个 URL

图片要求：

支持格式：JPG、JPEG、PNG、WEBP、HEIC、HEIF
单张大小：不超过 30MB
图片宽度和高度：均为 256–5760 px
宽高比（宽/高）：0.4–2.5
URL 必须使用 HTTP(S)，且可由服务端直接访问
整个 JSON 请求体大小不超过 64MB；不接受 Base64 或 mm_file:// 输入

示例:

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

duration

integer

默认值:5

输出视频时长（秒），默认为 5 秒。

取值限制：

仅支持 5–15 之间的整数，包括 5 和 15
不支持小数、数字字符串、auto 或 -1
输出时长与计费直接相关

必填范围: 5 <= x <= 15

示例:

5

quality

enum<string>

默认值:2k

输出视频分辨率，默认为 2k。

可选值：

2k：当前唯一支持的分辨率

注意：

768p 暂未开放，传入后会返回参数错误
输出码率、帧率、视频编码和音频编码由平台决定，当前不提供对应请求参数

可用选项:

2k

示例:

"2k"

aspect_ratio

enum<string>

默认值:adaptive

输出视频宽高比，默认为 adaptive。

可选值：

adaptive、21:9、16:9、4:3、1:1、3:4、9:16

图生视频规则：

实际宽高比由输入图片决定
传入上述其他合法值不会报错，但该值会被忽略并按 adaptive 处理
传入枚举外的值会返回参数错误

可用选项:

adaptive,

21:9,

16:9,

4:3,

1:1,

3:4,

9:16

示例:

"adaptive"

callback_url

string<uri>

任务完成后的 HTTPS 回调地址

回调时机：

任务完成（completed）或失败（failed）时触发
在计费确认完成后发送

安全限制：

仅支持 HTTPS 协议
禁止回调到内网 IP 地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x 等）
URL 长度不超过 2048 字符

回调机制：

超时时间：10 秒
失败后最多重试 3 次（分别在失败后 1/2/4 秒重试）
回调响应体格式与任务查询接口返回格式一致
返回 2xx 状态码视为成功，其他状态码触发重试

Pattern: ^https://

示例:

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

响应

视频生成任务创建成功

created

integer

任务创建时间戳

示例:

1761313744

string

任务ID

示例:

"task-unified-1774857405-abc123"

model

string

实际使用的模型名称

示例:

"minimax-h3-image-to-video"

object

enum<string>

任务的具体类型

可用选项:

video.generation.task

progress

integer

任务进度百分比 (0-100)

必填范围: 0 <= x <= 100

示例:

0

status

enum<string>

任务状态

可用选项:

pending,

processing,

completed,

failed

示例:

"pending"

task_info

object

视频任务详细信息

Show child attributes

type

enum<string>

任务的输出类型

可用选项:

text,

image,

audio,

video

示例:

"video"

usage

object

使用量和计费信息

Show child attributes

Minimax H3 Text-to-Video 文生视频 Minimax H3 Reference-to-Video 多模态参考生视频

图像系列

视频系列

音频系列

语言系列

账户管理

任务管理

文件管理

Minimax H3 Image-to-Video 图生视频

授权

请求体

响应