MiniMax · 介绍
MiniMax H3 视频模型，9 种工作流：文生视频、多图参考、4 图参考、MJ 风格参考、灵活多参考、首尾帧，以及三种 CF 超分（多图参考 / 首尾帧 / MJ，输出 2K/4K）。支持 8 种画面比例（16:9/9:16/1:1/4:3/3:4/3:2/2:3/21:9）× 清晰度档位（标准 480P/768P/1080P；CF 2K/4K），时长一般 4~15 秒（首尾帧与灵活多参考 4~10 秒）。可选参考视频（≤3）、音频（≤3）与提示词增强。提交 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）× resolution（标准档 480P/768P/1080P，默认 1080P；灵活多参考 lh 默认 768P）共同决定，上表为标准档矩阵。CF 超分工作流（cf-multi-reference / cf-fl2v / cf-mj）改用 resolution=2K/4K，按所选 ratio 比例超分输出、画质更高。多图参考 / MJ / CF 同族现支持参考视频输入（reference_videos，≤3 条）。
| 分辨率 | 宽高比 | 像素（size） |
|---|---|---|
| 480P | 16:9 | 864x480 |
| 768P | 16:9 | 1376x768 |
| 1080P | 16:9 | 1920x1088 |
| 480P | 9:16 | 480x864 |
| 768P | 9:16 | 768x1376 |
| 1080P | 9:16 | 1088x1920 |
| 480P | 1:1 | 640x640 |
| 768P | 1:1 | 1024x1024 |
| 1080P | 1:1 | 1440x1440 |
| 480P | 4:3 | 736x576 |
| 768P | 4:3 | 1184x896 |
| 1080P | 4:3 | 1664x1248 |
| 480P | 3:4 | 576x736 |
| 768P | 3:4 | 896x1184 |
| 1080P | 3:4 | 1248x1664 |
| 480P | 3:2 | 800x544 |
| 768P | 3:2 | 1248x832 |
| 1080P | 3:2 | 1760x1184 |
| 480P | 2:3 | 544x800 |
| 768P | 2:3 | 832x1248 |
| 1080P | 2:3 | 1184x1760 |
| 480P | 21:9 | 992x416 |
| 768P | 21:9 | 1568x672 |
| 1080P | 21:9 | 2208x960 |
常见错误
| 错误码 | msg | 含义 | 处理建议 |
|---|---|---|---|
| 400 | invalid_duration | duration 超出该工作流范围：一般 4~15，首尾帧 fl2v/cf-fl2v 与灵活多参考 lh 为 4~10 | 把 duration 设为整数：普通工作流 4~15；fl2v / cf-fl2v / lh-multi-reference 最长 10 |
| 400 | invalid_request | 缺 prompt（图生视频/首尾帧也必须给）、ratio 不在 8 种比例内、workflow_id 非法、resolution 不在该工作流允许档位、图/视频/音频超限、只传尾帧未传首帧、或 body 非法 | prompt 必填；ratio 须为 16:9/9:16/1:1/4:3/3:4/3:2/2:3/21:9 之一；workflow_id 须为 9 种之一；标准工作流 resolution 用 480P/768P/1080P、CF 用 2K/4K；image_urls≤9（lh≤4）、reference_videos≤3、audio_urls≤3；用 last_image 时必须同时传 first_image |
| 400 | invalid_reference_inputs | 素材与工作流不匹配：如文生视频却传了参考图、首尾帧（fl2v/cf-fl2v）与 image_urls/audio_urls/reference_videos 同传、灵活多参考传了参考视频/音频或超过 4 张图——各工作流仅接受其规定素材 | 按工作流传对应素材：首尾帧模式不要再传 image_urls / audio_urls / reference_videos；灵活多参考只传 ≤4 张图；文生视频不传任何素材 |
| 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 后，每个能力页都能直接「在线运行」。