认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必填
请求使用的模型 ID
值: minimax_hailuo_02_i2v
last_frame_image string
将指定图片作为视频的结束帧. 支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,…)
图片要求：
格式：JPG, JPEG, PNG, WebP
体积：小于 20MB
尺寸：短边像素大于 300px, 长宽比在 2:5 和 5:2 之间
⚠️ 生成视频尺寸遵循首帧图片, 当首帧和尾帧的图片尺寸不一致时, 模型将参考首帧对尾帧图片进行裁剪
prompt string
视频的文本描述, 最大 2000 字符.
支持使用 [指令] 语法进行运镜控制, 可在 prompt 中通过 [指令] 格式添加运镜指令, 以实现精确的镜头控制.
支持 15 种运镜指令：
左右移：[左移]、[右移]
左右摇：[左摇]、[右摇]
推拉：[推进]、[拉远]
升降：[上升]、[下降]
上下摇：[上摇]、[下摇]
变焦：[变焦推近]、[变焦拉远]
其他：[晃动]、[跟随]、[固定]
使用规则：
组合运镜：同一组 [] 内的多个指令会同时生效, 如 [左摇,上升], 建议组合不超过 3 个
顺序运镜：prompt 中前后出现的指令会依次生效, 如 ”…[推进], 然后…[拉远]“
自然语言：也支持通过自然语言描述运镜, 但使用标准指令能获得更准确的响应
first_frame_image string 必填
将指定图片作为视频的起始帧. 支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,…)
图片要求：
格式：JPG, JPEG, PNG, WebP
体积：小于 20MB
尺寸：短边像素大于 300px, 长宽比在 2:5 和 5:2 之间
⚠️ 生成视频尺寸遵循首帧图片
prompt_optimizer boolean
是否自动优化 prompt, 默认为 true. 设为 false 可进行更精确的控制
默认值: true
duration integer
视频时长（秒）, 可用值与分辨率相关：
| 分辨率 | 可用时长 |
|---|---|
| 768P | 6 或 10 |
| 1080P | 6 |
默认值: 6
resolution enum<string>
视频分辨率
图生视频：
| 时长 | 可用分辨率 |
|---|---|
| 6s | 512P, 768P（默认）, 1080P |
| 10s | 512P, 768P（默认） |
首尾帧生视频：
| 时长 | 可用分辨率 |
|---|---|
| 6s | 768P（默认）, 1080P |
| 10s | 768P |
可选值: 512P、768P、1080P
callback_url string
接收任务状态更新通知的回调 URL. 支持通过 callback_url 参数配置回调, 以接收任务状态更新的异步通知
aigc_watermark boolean
是否在生成的视频中添加水印
默认值: false
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息, 仅在状态为 failed 时存在
code
integer错误代码
error_message
string详细错误消息
output array
生成结果, 仅在状态为 completed 时存在
content
array生成内容列表
type
string资源类型, 例如
video、imageurl
string生成内容 URL
usage object
使用统计, 仅在状态为 completed 时存在
cost
string总成本（美元）
discount
number折扣金额
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 010004095 | 内部生成错误 |
| 010004096 | 结果解析错误 |
| 010004097 | HTTP 错误响应 |
| 010004098 | 状态检查错误 |
| 010004099 | 任务创建错误 |