视频 / MiniMax H3 B（图生）
minimax-h3-b
MiniMax H3 B（图生）：图生视频（必须带参考图）。按秒计费，3–15 s，480p / 720p / 1080p。
分组 #12「【视频】多模型 · 按秒 / 按条计费」 · Key 需属于该分组
图生视频（必须带参考图）按秒计费无额外收费仅图生视频需 1–9 张参考图
价格—
本站近期成功率—
平均耗时—
能力与限制
| 时长 | 3–15 s（整数，默认 5 s） |
| 分辨率 | 480p / 720p / 1080p（默认 720p） |
| 画面比例 | 16:9 / 9:16 |
| 参考图 | 必须 1–9 张（只支持图生视频，不支持参考视频 / 音频） |
| 首尾帧 | 不支持 |
| 额外收费 | 无。参考图、参考视频、参考音频均不另收费 |
| 计费 | 按秒：分辨率单价 × 秒数，失败不扣费 |
请求参数
OpenAI Videos 格式，JSON 或 multipart 均可；官方 SDK 的 client.videos.create 可直接使用。
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 固定为 minimax-h3-b |
prompt | string | 必填 | 画面描述，不能为空 |
seconds | string / integer | 可选 | 3–15 的整数；本站按此计费；不传按 5 秒 |
resolution | string | 可选 | 480p / 720p / 1080p；与 size 二选一；不传按 720p |
size | string | 可选 | 如 1280x720 / 720x1280，按像素换算成分辨率与画面比例；不能超过 1080p |
aspect_ratio | string | 可选 | 16:9 / 9:16 |
input_reference | string / file | 可选 | 参考图：HTTPS 直链，或 multipart 上传文件 |
images | array | 必填 | 必须传 1–9 张参考图 URL（或只用 input_reference 传 1 张） |
查询与下载
POST /v1/videos创建任务，拿到id。- 每 5–10 秒
GET /v1/videos/{id}；status依次为queued/in_progress/completed/failed。progress是上游给的真实进度，部分线路不提供（一直是 0，完成时变 100）；未完成时若有typical_seconds，表示本站该模型近 7 天的通常耗时（秒），仅供参考，不是这一单的预测。 completed后GET /v1/videos/{id}/content下载 mp4，用同一个 Key。- 超时不要重复创建，保留任务 id 继续查询。
注意事项
- 按秒计费：秒数 × 分辨率单价；最长 15 秒，不支持 2K / 4K。参考图、参考视频、参考音频均不另收费；不支持的素材直接报错，不扣费。
- 接口：创建 POST /v1/videos（JSON 或 multipart；JSON 也可发到 /v1/videos/generations）；查询 GET /v1/videos/{id}；下载 GET /v1/videos/{id}/content。
- 参考图须为公网 HTTPS 直链，或用 multipart 上传文件。
- 完成后请尽快通过 /content 下载，链接有时效。
常见错误
| 返回 | 原因与处理 |
|---|---|
400 | 时长、分辨率或尺寸超出本模型范围，按上表检查 |
429 / 503 | 线路繁忙，稍后重试；不要重复创建同一任务 |
status: failed | 查看返回的 error；多为内容审核或素材不可访问，失败的任务不扣费 |