MiniMax-H3
/api/v1/video/generationHeader Parameters
格式: Authorization: Bearer sk-xxxxxx
"enable"Request Body
application/json
模型名称。固定值：MiniMax-H3
"MiniMax-H3"多模态输入内容数组。每次请求必须包含一个非空 text 项（prompt 必填）。
支持的输入组合：
- 文生视频：仅一个 text 元素
- 图生视频-首帧：text + 1 张 image_url（role=first_frame 或不填）
- 图生视频-尾帧：text + 1 张 image_url（role=last_frame）
- 图生视频-首尾帧：text + 2 张 image_url（role 分别为 first_frame、last_frame）
- 多模态参考生视频：text + 参考图片（role=reference_image）+ 参考视频（role=reference_video）+ 参考音频（role=reference_audio）的组合
图生视频与多模态参考生视频互斥：content 中出现 reference_image/reference_video/reference_audio 任一 role，就不能再出现 first_frame/last_frame（反之亦然）。
请求体总大小 ≤ 64 MB，大文件请用公网 URL，勿用 Base64。
内容类型：text=文本，image_url=图片，video_url=视频，audio_url=音频
"text" | "image_url" | "video_url" | "audio_url"type=text 时必填。文本提示词（prompt），所有场景都需包含一个非空 text。最多 7000 个字符。
type=image_url 时必填。格式 JPG/JPEG/PNG/WEBP/HEIC/HEIF；单文件 ≤30MB；宽高 [256,5760]px；长宽比 [0.4,2.5]；数量：首帧≤1、尾帧≤1、参考图≤9。
图片来源：公网URL / mm_file://{file_id} / Base64编码(data:image/<格式>;base64,<内容>)。
type=video_url 时必填，仅多模态参考场景。格式 MP4/MOV（H.264/H.265，AAC/MP3）；单文件 ≤50MB；≤3个；单段时长[2,15]s，总时长≤15s；宽高[256,5760]px；长宽比[0.4,2.5]；帧率[23.976,60]。
视频来源：公网URL / mm_file://{file_id} / Base64编码。
type=audio_url 时必填，仅多模态参考场景。格式 WAV/MP3；单文件 ≤15MB；≤3段；单段时长[2,15]s，总时长≤15s。
音频来源：公网URL / mm_file://{file_id} / Base64编码(data:audio/<格式>;base64,<内容>)。
内容的位置或用途。
- first_frame：首帧图片（图生视频；仅一张图且不填 role 时默认按 first_frame 处理）
- last_frame：尾帧图片（图生视频-首尾帧，需与 first_frame 成对）
- reference_image：参考图片（多模态参考生视频）
- reference_video：参考视频（多模态参考生视频）
- reference_audio：参考音频（多模态参考生视频）
"first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio"视频分辨率。
"768P" | "2K"生成视频时长（秒），整数。
4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15生成视频的宽高比，默认 adaptive（自动，由输入自适应选择最合适的宽高比）。
- 文生视频（content 仅含 text）：ratio 必填，且不能为 adaptive；可用值 21:9/16:9/4:3/1:1/3:4/9:16
- 图生视频（content 含 first_frame/last_frame）：宽高比由输入图片决定，ratio 恒为 adaptive；传入其他值不会报错但会被忽略
- 多模态参考生视频（content 含 reference_image/reference_video/reference_audio）：ratio 可选，默认 adaptive；也可显式指定具体比例
"adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"任务状态变更的回调通知地址。配置后服务器会先发送含 challenge 字段的验证请求（需 3 秒内原样返回 challenge 完成验证），验证成功后每当任务状态变更即向该地址 POST 推送。
回调 status 取值：queued（排队中）、running（运行中）、succeeded（成功）、failed（失败）、cancelled（已取消）。
是否在生成视频中添加 AIGC 标识水印，默认 false。
返回原厂数据。默认 false：返回中继站标准响应格式（code+data+message+request_id）；true：仅返回 task_id。
falseResponse Body
application/json
成功
TypeScript Definitions
Use the response body type in TypeScript.
状态码
响应数据
生成结果URL列表
过期时间
任务ID
任务状态
提示信息
请求ID
curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \ -H "Authorization: enable" \ -H "Content-Type: application/json" \ -d '{ "model": "MiniMax-H3", "content": [ {} ], "resolution": "768P", "duration": 4, "return_original": false }'{
"code": 0,
"data": {
"urls": [
"string"
],
"usage": {
"images": 0,
"seconds": 0,
"input_tokens": 0,
"total_tokens": 0,
"output_tokens": 0
},
"expired": "string",
"task_id": "string",
"task_status": "string"
},
"message": "string",
"request_id": "string"
}