视频生成 API
概述
接口信息
POST /v1/tasks/generationsapplication/json模型能力
支持的模型
| 模型名称 | 模型 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 系列）
支持的运镜指令
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
}修改于 2025-11-20 05:03:23