视频生成 API

概述

Minimax 视频生成 API，支持文生视频、图生视频和主体参考视频生成。提供多种模型选择，支持不同分辨率和时长的高质量视频内容生成。

接口信息

请求地址： POST /v1/tasks/generations

内容类型： application/json

认证方式： Bearer Token

请求头示例：

模型能力

支持的模型

模型名称	模型 ID	支持功能	特点
T2V-01-Director	`minimax/t2v-01-director`	文生视频	支持运镜控制的文生视频，720p 分辨率
I2V-01-Director	`minimax/i2v-01-director`	图生视频	支持运镜控制的图生视频，720p 分辨率
I2V-01-live	`minimax/i2v-01-live`	图生视频	实时图生视频，720p 分辨率
S2V-01	`minimax/s2v-01`	主体参考视频	基于主体参考生成视频，720p 分辨率

参数说明

基础参数

参数名	类型	必填	默认值	描述	限制
`model`	string	✅	-	模型 ID	见支持的模型列表
`prompt`	string	❌	-	文本提示词	≤2000字符，支持中英文

视频生成参数

参数名	类型	必填	默认值	描述	取值范围
`duration`	int	❌	6	视频时长（秒）	`6`（固定）
`resolution`	string	❌	720P	视频分辨率	`720P`（固定）
`prompt_optimizer`	bool	❌	true	提示词优化开关	`true`, `false`
`aigc_watermark`	bool	❌	false	是否添加 AIGC 水印	`true`, `false`

图像相关参数

图生视频

参数名	类型	必填	默认值	说明
`first_frame_image`	string	视模型而定	-	首帧图像（URL/Base64）

主体参考视频（仅 S2V-01）

参数名	类型	必填	默认值	说明
`subject_reference`	array	✅	-	主体参考配置（目前仅支持单主体）
`subject_reference[0].type`	string	✅	-	主体类型，仅支持 `character`
`subject_reference[0].image`	array	✅	-	主体参考图片数组（长度为1）

参数详细说明

模型功能支持

功能类型	T2V-01-Director	I2V-01-Director	I2V-01-live	S2V-01
文生视频	✅	❌	❌	❌
图生视频	❌	✅	✅	❌
主体参考	❌	❌	❌	✅
运镜控制	✅	✅	❌	❌

分辨率与时长支持

所有模型（T2V-01-Director, I2V-01-Director, I2V-01-live, S2V-01）

模型	时长	分辨率	说明
所有模型	6秒	720P	固定参数，不可调节

首帧图像要求

必填条件

模型	分辨率	首帧图像要求
T2V-01-Director	720P	❌ 不需要
I2V-01-Director	720P	✅ 必填
I2V-01-live	720P	✅ 必填
S2V-01	720P	❌ 不需要（使用主体参考）

图片格式要求

项目	要求
格式	JPG、JPEG、PNG、WebP
大小	≤ 20MB
短边像素	≥ 300px
宽高比	2:5 到 5:2 之间
编码	Base64（`data:image/<format>;base64,<data>`）或 HTTP URL

运镜控制（Director 系列）

支持的运镜指令

T2V-01-Director、I2V-01-Director 支持通过在 prompt 中插入运镜指令来控制画面运动。

15种运镜方式

类型	指令	说明
左右移	`[左移]`, `[右移]`	摄像机左右平移
左右摇	`[左摇]`, `[右摇]`	摄像机左右摇摆
推拉	`[推进]`, `[拉远]`	摄像机前后推拉
升降	`[上升]`, `[下降]`	摄像机上下移动
上下摇	`[上摇]`, `[下摇]`	摄像机上下摇摆
变焦	`[变焦推近]`, `[变焦拉远]`	镜头变焦效果
晃动	`[晃动]`	摄像机晃动效果
跟随	`[跟随]`	跟随拍摄
固定	`[固定]`	固定机位拍摄

文生视频 (Text-to-Video)

基础文生视频

支持通过文本描述生成视频内容，适用于创意视频制作、广告素材生成等场景。

请求示例

基础文生视频

{
  "model": "minimax/t2v-01-director",
  "prompt": "一只可爱的小猫在花园里追逐蝴蝶，阳光明媚，画面温馨",
  "prompt_optimizer": true,
  "aigc_watermark": false
}

运镜控制文生视频

{
  "model": "minimax/t2v-01-director",
  "prompt": "壮观的山脉景色，云雾缭绕[推进]，日出时分，金色阳光洒向大地[左摇]",
  "prompt_optimizer": true
}

优化提示词设置

{
  "model": "minimax/t2v-01-director",
  "prompt": "夜晚的城市街道，霓虹灯闪烁，车水马龙，赛博朋克风格",
  "prompt_optimizer": false,
  "aigc_watermark": true
}

图生视频 (Image-to-Video)

概述

基于输入的首帧图像生成动态视频，让静态图片"动起来"。支持多种模型和分辨率选择。

请求示例

基础图生视频（使用 Base64）

{
  "model": "minimax/i2v-01-director",
  "first_frame_image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "prompt": "让图片中的人物微笑并轻轻点头",
  "prompt_optimizer": true
}

图生视频（使用 URL）

{
  "model": "minimax/i2v-01-director",
  "first_frame_image": "https://example.com/input.jpg",
  "prompt": "让场景动起来，添加微风效果",
  "prompt_optimizer": true
}

无提示词图生视频

{
  "model": "minimax/i2v-01-live",
  "first_frame_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...",
  "prompt_optimizer": true
}

运镜控制图生视频

{
  "model": "minimax/i2v-01-director",
  "first_frame_image": "https://example.com/landscape.jpg",
  "prompt": "风景图片中的云朵流动起来[右移]，阳光透过云层[变焦推近]",
  "prompt_optimizer": true
}

主体参考视频 (Subject-to-Video)

概述

基于主体参考图像生成视频，目前仅支持人物面部主体参考，适用于人像视频生成。

请求示例

单主体参考视频

{
  "model": "minimax/s2v-01",
  "subject_reference": [
    {
      "type": "character",
      "image": ["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."]
    }
  ],
  "prompt": "一个人在咖啡厅里微笑着喝咖啡，温馨的画面",
  "prompt_optimizer": true
}

使用 URL 的主体参考

{
  "model": "minimax/s2v-01",
  "subject_reference": [
    {
      "type": "character",
      "image": ["https://example.com/face.jpg"]
    }
  ],
  "prompt": "主体人物在公园里散步，享受阳光",
  "aigc_watermark": false
}

概述#

接口信息#

模型能力#

支持的模型#

参数说明#

基础参数#

视频生成参数#

图像相关参数#

图生视频#

主体参考视频（仅 S2V-01）#

参数详细说明#

模型功能支持#

分辨率与时长支持#

所有模型（T2V-01-Director, I2V-01-Director, I2V-01-live, S2V-01）#

首帧图像要求#

必填条件#

图片格式要求#

运镜控制（Director 系列）#

支持的运镜指令#

15种运镜方式#

文生视频 (Text-to-Video)#

基础文生视频#

请求示例#

基础文生视频#

运镜控制文生视频#

优化提示词设置#

图生视频 (Image-to-Video)#

概述#

请求示例#

基础图生视频（使用 Base64）#

图生视频（使用 URL）#

无提示词图生视频#

运镜控制图生视频#

主体参考视频 (Subject-to-Video)#

概述#

请求示例#

单主体参考视频#

使用 URL 的主体参考#

概述

接口信息

模型能力

支持的模型

参数说明

基础参数

视频生成参数

图像相关参数

图生视频

主体参考视频（仅 S2V-01）

参数详细说明

模型功能支持

分辨率与时长支持

所有模型（T2V-01-Director, I2V-01-Director, I2V-01-live, S2V-01）

首帧图像要求

必填条件

图片格式要求

运镜控制（Director 系列）

支持的运镜指令

15种运镜方式

文生视频 (Text-to-Video)

基础文生视频

请求示例

基础文生视频

运镜控制文生视频

优化提示词设置

图生视频 (Image-to-Video)

概述

请求示例

基础图生视频（使用 Base64）

图生视频（使用 URL）

无提示词图生视频

运镜控制图生视频

主体参考视频 (Subject-to-Video)

概述

请求示例

单主体参考视频

使用 URL 的主体参考