Hailuo 2.3 Fast - Image to Video

minimax_hailuo_23_fast_i2v

Hailuo 2.3 Fast Image to Video 提供快速图像动画，在保持视觉质量的同时优化处理速度。

调用地址

POST /v1/queue/minimax_hailuo_23_fast_i2v # 创建任务

GET /v1/queue/minimax_hailuo_23_fast_i2v/requests/{request_id}/status # 查询状态

GET /v1/queue/minimax_hailuo_23_fast_i2v/requests/{request_id}/response # 获取结果

PUT /v1/queue/minimax_hailuo_23_fast_i2v/requests/{request_id}/cancel # 取消任务

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_fast_i2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "first_frame_image": "https://image.cdn2.seaart.me/2026-06-01/d8ejq1de878c739e2lrg/995ff4fe1eeec10a06c3c7a172862733.webp",
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "duration": 6,
    "resolution": "768P"
  }'

first_frame_image string 必填

将指定图片作为视频的起始帧。支持公网 URL 或 Base64 编码的 Data URL，例如 data:image/jpeg;base64,...

图片格式：JPG、JPEG、PNG、WebP

图片体积：小于 20MB

图片尺寸：短边像素大于 300px，长宽比在 2:5 和 5:2 之间

prompt string

视频的文本描述。支持使用 [指令] 语法进行运镜控制，可在 prompt 中通过 [指令] 格式添加运镜指令，以实现精确的镜头控制

支持运镜指令：[左移]、[右移]、[左摇]、[右摇]、[推进]、[拉远]、[上升]、[下降]、[上摇]、[下摇]、[变焦推近]、[变焦拉远]、[晃动]、[跟随]、[固定]

最大长度：2000 字符

duration int

视频时长，单位为秒

分辨率 768P：可用时长 6 或 10

分辨率 1080P：可用时长 6

可选值：6、10

默认值：6

resolution string

视频分辨率。6s 支持 768P、1080P，10s 支持 768P

可选值：768P、1080P

默认值：768P

prompt_optimizer bool

是否自动优化 prompt。设为 false 可进行更精确的控制

默认值：true

fast_pretreatment bool

是否缩短 prompt_optimizer 的优化耗时

默认值：false

aigc_watermark bool

是否在生成的视频中添加水印

默认值：false

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_fast_i2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_fast_i2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/minimax_hailuo_23_fast_i2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

字段	类型	说明
`request_id`	string	任务 ID，后续查询、获取结果和取消都使用它
`response_url`	string	获取最终结果的 URL
`status_url`	string	查询任务状态的 URL
`cancel_url`	string	取消任务的 URL
`queue_position`	int	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理