视频 / MiniMax H3（lh 线路）
minimax-h3-lh
MiniMax H3（lh 线路）：文生视频、图生视频、参考图。按秒计费，1–15 s，480p / 720p（上游 768）。
分组 #12「【视频】多模型 · 按秒 / 按条计费」 · Key 需属于该分组
文生视频图生视频参考图按秒计费无额外收费seconds 必填
价格—
本站近期成功率—
平均耗时—
能力与限制
| 时长 | 1–15 s（整数，必须传） |
| 分辨率 | 480p / 720p（上游 768）（默认 480p） |
| 画面比例 | 由 size 推算（如 1280x720 → 16:9） |
| 参考图 | 可传（input_reference 或 images）；张数上限上游未说明 |
| 首尾帧 | 上游未说明 |
| 额外收费 | 无。参考图、参考视频、参考音频均不另收费 |
| 计费 | 按秒：分辨率单价 × 秒数，失败不扣费 |
请求参数
OpenAI Videos 格式，JSON 或 multipart 均可；官方 SDK 的 client.videos.create 可直接使用。
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 固定为 minimax-h3-lh |
prompt | string | 必填 | 画面描述，不能为空 |
seconds | string / integer | 必填 | 1–15 的整数；本站按此计费 |
resolution | string | 可选 | 480p / 720p（768 视为 720p）；与 size 二选一；不传按 480p |
size | string | 可选 | 如 1280x720 / 720x1280，按像素换算成分辨率与画面比例；不能超过 1080p |
aspect_ratio | string | 可选 | 如 16:9 / 9:16 / 1:1；不传时按 size 推算 |
input_reference | string / file | 可选 | 参考图：HTTPS 直链，或 multipart 上传文件 |
images | array | 可选 | 多张参考图 URL 数组 |
查询与下载
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；多为内容审核或素材不可访问，失败的任务不扣费 |