API Reference
MiniMax H3 全能参考 API
POST
minimax-h3-api
ID 40
MiniMax H3 全能参考视频生成接口，提供参考控制类生成能力，参数以文档为准。
POST
https://xiaoapis.com/api/video/minimaxrtv
概述
- 全能参考
- 异步任务
适用场景
- 可控视频生成
- 参考驱动创意
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key（Query 或 JSON Body，以本接口为准） - 回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200
鉴权
请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理 创建密钥。
POST https://xiaoapis.com/api/video/minimaxrtv
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://xiaoapis.com/api/video/minimaxrtv?key=你的密钥
详细说明
请求HEADER：
| 名称 | 值 |
|---|---|
| Content-Type | application/json |
请求参数说明：
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| prompt | 是 | string | 一个宁静的海滩在日落时分，海浪轻轻拍打着海岸，棕榈树随风摇曳，海鸥在橙色天空中飞翔。 | 用于生成视频的文本提示词。(最大长度:30000个字符) |
| callBackUrl | 是 | string | https://your-domain.com/api/callback | 回调地址，接收生成任务完成更新的URL。但推荐用于生产环境使用。当生成完成后，系统将向此URL发送任务状态和结果的POST请求。 |
| reference_image_urls | 是 | array[string<URL>] | ["https://file.aiquickdraw.com/example1.png"] | 参考图像URL列表, 1≤ n ≤9 张图片，最多支持9张图像。支持 HTTP、HTTPS 和 OSS地址3项支持的图像格式包括JPG、JPEG、PNG、WEBP、HEIC和 HEIF; 单个图像的尺寸不得超过 30 MB;图像的边长必须在 256 至 5760 像素之间，且长宽比必须在 0.4 至 2.5 之间。 |
| reference_video_urls | 否 | array[string<URL>] | ["https://file.aiquickdraw.com/example1.mp4"] | 参考视频URL列表, 支持 ≤3 个视频，支持 MP4、MOV格式;视频编码支持 H.264、H.265，音频编码支持 AAC、MP3;单个文件大小不得超过 50MB;单个片段的持续时间为2至15秒，所有参考视频的总持续时间不得超过15 秒;视频边长必须在 256 至 5760 像素之间，纵横比必须在 0.4 至 2.5 之间，帧速率必须在 23.976 至 60 之间。 |
| reference_audio_urls | 否 | array[string<URL>] | ["https://file.aiquickdraw.com/example1.wav"] | 参考音频URL列表, 支持 ≤ 3 个音频，支持 WAV、MP3 格式;单个文件大小不得超过 15 MB;单个片段的持续时间为2至 15 秒，而所有参考音频的总持续时间不得超过 15 秒。参考音频不能单独使用，必须与参考图像或参考视频一同呈现。 |
| resolution | 否 | string | 720p | 生成视频的分辨率，视频分辨率2K用于更快生成，720p用于平衡。允许的值:2K、720p, 注意:默认720p。 |
| aspect_ratio | 否 | string | 16:9 | 生成视频的宽高比，视频宽高比配置。允许的值:1:1、4:3、3:4、16:9、9:16、adaptive(自适应)、21:9；默认值:16:9。 |
| duration | 否 | int | 10 | 生成视频的时长，视频时长在4到15秒之间；注意:默认10。 |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | string | 请求结果数据集 |
| -- task_id | string | 任务 ID 可以查询任务状态 |
| debug | string/array | 调试数据 |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |
常见问题
H3 全能参考适合什么？
需要参考输入提升可控性的视频生成场景。
如何调用？
按文档提交参考与提示参数，异步获取结果。
和 Seedance 2.5 如何选？
不同模型风格，建议按样片效果与成本选择。
是否支持回调？
若文档提供 notify/callback 字段则支持。
限流与计费？
以控制台与文档为准。
相关接口
完整控制台文档（含调试台）：/doc/40