创建图生视频任务（I2V）

文档版本：v1.0.0 | 最后更新：2026-06-05
本平台已完整适配海螺（MiniMax / Hailuo）官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

输入图片及文本内容，以图片作为首帧创建视频生成任务。

POST https://platform.shuyanai.com/hailuo/v1/video_generation

请求参数

参数	类型	必填	默认值	说明
`model`	string (enum)	是	—	模型名称。可用值：`MiniMax-Hailuo-2.3`、`MiniMax-Hailuo-2.3-Fast`、`MiniMax-Hailuo-02`、`I2V-01-Director`、`I2V-01-live`、`I2V-01`
`first_frame_image`	string	是	—	作为视频起始帧的图片。支持公网 URL 或 Base64 编码的 Data URL（`data:image/jpeg;base64,...`）。图片要求见下
`prompt`	string	否	—	视频文本描述，最大 2000 字符。`MiniMax-Hailuo-2.3`、`MiniMax-Hailuo-2.3-Fast`、`MiniMax-Hailuo-02`、`I2V-01-Director` 系列支持 `[指令]` 运镜控制（见附录）
`prompt_optimizer`	boolean	否	`true`	是否自动优化 prompt。设为 `false` 可进行更精确的控制
`fast_pretreatment`	boolean	否	`false`	是否缩短 prompt 优化耗时。仅对 `MiniMax-Hailuo-2.3`、`MiniMax-Hailuo-2.3-Fast`、`MiniMax-Hailuo-02` 生效
`duration`	integer	否	`6`	视频时长（秒），可用值与模型、分辨率相关（见下表）
`resolution`	string (enum)	否	见下表	视频分辨率。可用值：`512P`、`720P`、`768P`、`1080P`
`callback_url`	string	否	—	任务状态变更回调通知地址（见附录）
`aigc_watermark`	boolean	否	`false`	是否在生成视频中添加水印

格式：JPG、JPEG、PNG、WebP

体积：小于 20MB

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

{
  "task_id": "106916112212032",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段	类型	说明
`task_id`	string	视频生成任务 ID，用于查询任务状态
`base_resp`	object	通用响应状态（`status_code` / `status_msg`）