1. 视频生成（Videos）
AI接口文档
  • 图片生成（Images）
    • 香蕉（异步）
      POST
    • image2（同步）
      POST
    • gpt-image-2（异步）
      POST
    • 任务查询
      GET
  • 视频生成（Videos）
    • Omni创建
      POST
    • veo创建
      POST
    • Grok创建
      POST
    • Seedance创建
      POST
    • MiniMax创建
      POST
    • 任务查询
      GET
  • 失效接口
    • sora创建
      POST
    • veo（直出15s）
      POST
    • Veo （延长至15s）
      POST
  1. 视频生成（Videos）

MiniMax创建

开发中
POST
/v1/videos

MiniMax 视频生成接口文档#

接口地址#

POST /v1/videos

功能说明#

支持 MiniMax H3 系列模型的文生视频，以及图片、视频、音频参考内容驱动的视频生成。

当前模型#

模型名支持模式时长说明
minimax-h3文生视频、参考内容生成4～15 秒MiniMax H3 标准模型
minimax-h3-max文生视频、参考内容生成4～15 秒MiniMax H3 Max 模型
两款模型都通过 seconds 指定 4～15 秒的输出时长。调用时必须使用表格中的完整模型名。

模式判定#

模式传参方式
文生视频不传 images、videos、audios，或全部传空数组
参考内容生成至少传入一项图片、视频或音频参考内容
MiniMax H3 的参考素材按“参考内容”使用。应在 prompt 中说明每项素材的作用和编号。

请求方式#

方式Content-Type参考素材字段
JSONapplication/jsonimages、videos、audios
表单multipart/form-data只使用可重复的 input_reference
表单没有 video_reference 或 audio_reference 字段。无论文件类型，均重复使用 input_reference。

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是application/json 或 multipart/form-data

JSON 请求体说明#

参数名类型必填说明
modelstring是minimax-h3 或 minimax-h3-max
promptstring是视频生成提示词
imagesstring[]否图片 URL 或完整 Base64 data URI
videosstring[]否可公网访问的视频文件直链
audiosstring[]否可公网访问的音频文件直链
aspect_ratiostring否支持 16:9、9:16、1:1、4:3、3:4、21:9
resolutionstring否输出分辨率，例如 720p、1080p；可用值以服务端配置为准
secondsstring是输出时长，字符串形式，支持 "4"～"15"

参考素材 JSON 结构#

{
  "images": [
    "https://example.com/ref.png"
  ],
  "videos": [
    "https://example.com/ref.mp4"
  ],
  "audios": [
    "https://example.com/ref.mp3"
  ]
}
数组元素必须直接填写实际 URL。例如应填写 "https://example.com/ref.png"，不要填写 Markdown 形式的 [https://...](https://...)。

素材数量约定#

图片、视频、音频合计最多 9 项。
多项素材按各自数组中的顺序编号为图片 1、图片 2、视频 1、音频 1 等。
文件数量越多、单个文件越大，上传和生成耗时越长。

表单字段说明#

参数名类型必填说明
modelstring是minimax-h3 或 minimax-h3-max
promptstring是视频生成提示词
input_reference可重复字段否图片、视频、音频文件或 URL；每项重复传一次
aspect_ratiostring否视频宽高比
resolutionstring否输出分辨率，可用值以服务端配置为准
secondsstring是输出时长，支持 4～15

input_reference 的传法#

方式示例
本地图片-F "input_reference=@/path/to/ref.png"
本地视频-F "input_reference=@/path/to/ref.mp4"
本地音频-F "input_reference=@/path/to/ref.mp3"
公网直链-F "input_reference=https://example.com/ref.png"

请求示例#

文生视频（JSON）#

单图参考（JSON）#

多图参考（JSON）#

图片、视频和音频组合参考（JSON）#

图片 + 音频（JSON）#

本地组合参考文件（表单，仅使用 input_reference）#

响应参数#

完成态视频地址位于顶层 url 和 video_url，两者值相同。
参数名类型说明
idstring任务 ID
objectstring固定值 video
modelstring实际使用的模型名称
statusstringqueued、in_progress、completed、failed
progressnumber任务进度，0～100
created_atnumber创建时间戳（秒）
completed_atnumber完成时间戳（秒，仅完成态）
urlstring视频直链（仅完成态）
video_urlstring与 url 同值（仅完成态）
errorobject失败信息，通常包含 code、message

提交成功#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "minimax-h3",
  "status": "queued",
  "progress": 0,
  "created_at": 1791320000
}

任务完成#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "minimax-h3",
  "status": "completed",
  "progress": 100,
  "created_at": 1791320000,
  "completed_at": 1791320060,
  "url": "https://example.com/output.mp4",
  "video_url": "https://example.com/output.mp4"
}

任务失败#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "minimax-h3",
  "status": "failed",
  "progress": 0,
  "created_at": 1791320000,
  "error": {
    "code": "invalid_request",
    "message": "请求参数不符合模型能力限制"
  }
}

查询任务状态#

GET /v1/videos/{task_id}
queued / in_progress 时继续轮询；completed 时读取顶层 url 或 video_url；failed 时读取 error.message。

注意事项#

1.
minimax-h3 和 minimax-h3-max 的 seconds 都必须使用字符串，支持 "4"～"15"。
2.
文生视频不传参考素材；传入任意参考素材后按参考内容模式处理。
3.
JSON 分别用 images、videos、audios；表单只有可重复的 input_reference。
4.
JSON 数组元素只填写实际文件直链或受支持的 data URI，不要填写 Markdown 链接语法。
5.
图片、视频、音频合计最多 9 项；建议在 prompt 中明确每项素材的编号和用途。
6.
URL 必须是无需登录、可直接返回文件内容的公网直链。
7.
分辨率是否可用取决于具体模型配置；未确认时可不传 resolution，使用模型默认值。
8.
接口为异步接口，提交成功后需轮询任务状态。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "model": "minimax-h3",
    "prompt": "图片 1 提供产品外观，视频 1 提供镜头运动，音频 1 控制剪辑节奏",
    "images": [
      "https://example.com/ref.png"
    ],
    "videos": [
      "https://example.com/ref.mp4"
    ],
    "audios": [
      "https://example.com/ref.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "seconds": "12"
  }

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "minimax-h3",
    "prompt": "图片 1 提供产品外观，视频 1 提供镜头运动，音频 1 控制剪辑节奏",
    "images": [
      "https://example.com/ref.png"
    ],
    "videos": [
      "https://example.com/ref.mp4"
    ],
    "audios": [
      "https://example.com/ref.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "seconds": "12"
  }'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "veo_3_1-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "size": "1920x1080"
}
修改于 2026-10-07 13:36:44
上一页
Seedance创建
下一页
任务查询
Built with