洛辞 API 文档
管理密钥
API 文档/MiniMax H3

视频生成 · API v1

MiniMax H3 视频 API

通过文字或参考图片生成视频，使用独立 API 积分。

POST/api/v1/videos/generations

模型与参数

modelId

h3

prompt

视频画面描述，必填

duration

4–15 秒，步长 1；默认 5 秒

imageSize

768P / 2K

aspectRatio

adaptive / 1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 21:9

referenceUrls

可选，公开图片 URL 数组，最多 9 张；可搭配参考视频或音频

videoInputMode

keyframes / references；默认 keyframes

referenceVideoUrls

可选，公开视频 URL 数组，最多 3 段

referenceAudioUrls

可选，公开音频 URL 数组，最多 3 段；素材组合由模型能力校验

keyframePositions

可选，首尾帧角色数组，与 referenceUrls 一一对应。单独尾帧传 ["last_frame"]；首尾帧传 ["first_frame","last_frame"]。

referenceImageOrder

可选，图片顺序数组；每项为 url: 加对应 referenceUrls 中的完整地址，必须恰好覆盖全部参考图片

每次输出一个视频。参考图片数量、首尾帧和参考图模式以模型支持能力为准；不支持的组合会返回参数错误。

参考视频与音频

多模态参考：referenceVideoUrls、referenceAudioUrls 为公开 HTTP(S) URL 数组，各最多 3 段，videoInputMode 使用 references（提供参考视频或音频时也可省略，系统会自动选择）。视频支持 MP4/MOV、H.264/H.265 编码、AAC/MP3 音轨，每段不超过 50MB、2–15 秒，合计最多 15 秒；画面每边 256–5760 像素，宽高比 0.4–2.5，帧率 23.976–60。音频支持 MP3/WAV，每段不超过 15MB、2–15 秒，合计最多 15 秒，必须搭配图片或视频。不得与 keyframePositions 或首尾帧模式混用。时长由服务端检测，不接受客户端上报；首次报价会导入并检测素材，后续请求复用已检测素材。

{
  "modelId": "h3",
  "prompt": "参考视频中的镜头运动，使用音频中的声音方向",
  "imageSize": "768P",
  "duration": 5,
  "videoInputMode": "references",
  "referenceVideoUrls": [
    "https://example.com/reference.mp4"
  ],
  "referenceAudioUrls": [
    "https://example.com/reference.mp3"
  ]
}

报价与 API 积分

详细价格表

24 个价格档位
MiniMax H3 API 调用价格
分辨率时长API 积分 / 次
768P4 秒0.4
768P5 秒0.5
768P6 秒0.6
768P7 秒0.7
768P8 秒0.8
768P9 秒0.9
768P10 秒1
768P11 秒1.1
768P12 秒1.2
768P13 秒1.3
768P14 秒1.4
768P15 秒1.5
2K4 秒0.65
2K5 秒0.8125
2K6 秒0.975
2K7 秒1.1375
2K8 秒1.3
2K9 秒1.4625
2K10 秒1.625
2K11 秒1.7875
2K12 秒1.95
2K13 秒2.1125
2K14 秒2.275
2K15 秒2.4375

1 美元 = 1 API 积分。售价最多保留 4 位小数；表内为不含参考媒体及附加选项的单个视频售价。

参考视频、参考音频、参考图片及模型支持的附加选项可能影响费用；请向报价接口提交完整参数，以返回的报价为准。

前 5 张参考图片免费，之后每张附加费约 0.045 API 积分；最终总价以完整参数报价为准。

参考视频按检测到的输入总时长向上取整后，与输出时长一起计费；参考音频免费，但不能单独使用。

默认配置：每次 0.5 API 积分（5 秒）。向 POST /api/v1/videos/quote 提交相同参数查询 estimatedPoints；报价不创建任务，也不冻结积分。分辨率、时长、声音与快速模式可能影响价格。

1 美元 = 1 API 积分，支持小数。API 钱包和价格独立，不享受网站会员折扣。提交时冻结 API 积分，任务结束后按模型规则结算。充值 API 积分

查询与下载视频

成功提交返回 HTTP 202 和 taskId。每 3–5 秒请求 GET /api/v1/tasks/{taskId}，queued 和 processing 状态继续等待；succeeded、partial、failed 状态停止轮询。settled 为 true 时，chargedPoints 是最终扣费。

task.videos[].url 是本站视频下载路径，下载也必须携带 API Key。视频遵循本站保留期限，过期返回 410，请及时下载保存。只能访问本人 API 任务。

幂等重试

每个新任务设置不同的 Idempotency-Key，8–128 位字母、数字或 ._:-。超时重试保持相同键和参数，避免重复冻结；改变参数返回 409。有效密钥不设请求频率和网页会员并发上限。

错误处理

400 参数或报价组合无效；401 密钥无效；402 API 积分不足；404 任务不存在或无权访问；409 幂等冲突；410 视频已过期；5xx 服务暂不可用。错误包含 error 和 code，不返回内部调用信息。