MiniMax · 视频
MiniMax · 介绍
MiniMax H3 视频模型，支持文生视频、图生视频与音频引导生成。支持 8 种画面比例（16:9/9:16/1:1/4:3/3:4/3:2/2:3/21:9），时长 4~15 秒。提交 POST /v1/videos 返回 task_id，轮询 GET /v1/videos/{task_id} 直到 status = success / failed。
🔗 查询响应为 OpenAI 视频任务格式：顶层字段结构（不套 {code,msg,data} 壳），状态小写 queued / running / success / failed，成功返回 video_url，失败返回 {"error":{"code","message"}}；video_url 为我方 CDN 直链，可直接下载/播放。
怎么调用
- 提交：
POST /v1/videos，返回 taskId。 - 查询：
GET /v1/videos/{taskId}，轮询到 status = success / failed。
能力地图
尺寸 / 分辨率对照
画幅唯一入口是 ratio（8 选 1，默认 16:9），每种比例定档一个固定分辨率——一个字段同时锁定画幅与清晰度，无需再传像素尺寸或清晰度参数。清晰度按比例自动匹配、不额外收费（按秒计费、与分辨率无关，任选比例价格一致）。不支持视频参考输入。
| 分辨率 | 宽高比 | 像素（size） |
|---|---|---|
| ≈2.0MP | 16:9 | 1920x1080 |
| ≈2.0MP | 9:16 | 1080x1920 |
| ≈1.05MP | 1:1 | 1024x1024 |
| ≈1.23MP | 4:3 | 1280x960 |
| ≈1.23MP | 3:4 | 960x1280 |
| ≈1.38MP | 3:2 | 1440x960 |
| ≈1.38MP | 2:3 | 960x1440 |
| ≈1.89MP | 21:9 | 2100x900 |
常见错误
| 错误码 | msg | 含义 | 处理建议 |
|---|---|---|---|
| 400 | invalid_duration | duration 不在 4~15 范围 | 把 duration 设为 4~15 的整数 |
| 400 | invalid_request | 缺 prompt（图生视频也必须给）、ratio 不在 8 种比例内、图/音频超限、或 body 非法 | prompt 必填；ratio 须为 16:9/9:16/1:1/4:3/3:4/3:2/2:3/21:9 之一；image_urls≤9、audio_urls≤3 |
| 401 | unauthorized | API Key 缺失或无效 | 检查 Authorization: Bearer <API_KEY> 是否正确 |
| 402 | insufficient_balance | 积分余额不足 | 充值后重试 |
| 429 | task_limit_reached | 在途任务过多 | 等待部分任务完成后再提交 |
| 404 | not_found | 任务不存在或非本账户任务 | 核对 taskId 是否正确 |
| 4xx/5xx | upstream_error | 生成服务返回错误（提交阶段不计费；生成阶段失败会自动退款） | 稍后重试；持续失败请联系支持 |
错误统一返回 {"error":{"code":"...","message":"..."}}。
提示：右上角 Authorize 保存 APIKey 后，每个能力页都能直接「在线运行」。