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

视频生成 · API v1

MiniMax H3 Lite 视频 API

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

POST/api/v1/videos/generations

模型与参数

modelId

h3-lite

prompt

视频画面描述，必填

duration

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

imageSize

480P / 768P / 1080P / 2K / 4K

aspectRatio

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

referenceUrls

可选，公开图片 URL 数组；不支持参考视频或参考音频

videoInputMode

keyframes；默认 keyframes

quality

low / high；默认 low

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

报价与 API 积分

详细价格表

130 个价格档位
MiniMax H3 Lite API 调用价格
分辨率时长质量API 积分 / 次
480P3 秒low0.0507
480P4 秒low0.0675
480P5 秒low0.0844
480P6 秒low0.1013
480P7 秒low0.1182
480P8 秒low0.135
480P9 秒low0.1519
480P10 秒low0.1688
480P11 秒low0.1857
480P12 秒low0.2025
480P13 秒low0.2194
480P14 秒low0.2363
480P15 秒low0.2532
480P3 秒high0.1132
480P4 秒high0.13
480P5 秒high0.1469
480P6 秒high0.1638
480P7 秒high0.1807
480P8 秒high0.1975
480P9 秒high0.2144
480P10 秒high0.2313
480P11 秒high0.2482
480P12 秒high0.265
480P13 秒high0.2819
480P14 秒high0.2988
480P15 秒high0.3157
768P3 秒low0.06
768P4 秒low0.08
768P5 秒low0.1
768P6 秒low0.12
768P7 秒low0.14
768P8 秒low0.16
768P9 秒low0.18
768P10 秒low0.2
768P11 秒low0.22
768P12 秒low0.24
768P13 秒low0.26
768P14 秒low0.28
768P15 秒low0.3
768P3 秒high0.1225
768P4 秒high0.1425
768P5 秒high0.1625
768P6 秒high0.1825
768P7 秒high0.2025
768P8 秒high0.2225
768P9 秒high0.2425
768P10 秒high0.2625
768P11 秒high0.2825
768P12 秒high0.3025
768P13 秒high0.3225
768P14 秒high0.3425
768P15 秒high0.3625
1080P3 秒low0.0825
1080P4 秒low0.11
1080P5 秒low0.1375
1080P6 秒low0.165
1080P7 秒low0.1925
1080P8 秒low0.22
1080P9 秒low0.2475
1080P10 秒low0.275
1080P11 秒low0.3025
1080P12 秒low0.33
1080P13 秒low0.3575
1080P14 秒low0.385
1080P15 秒low0.4125
1080P3 秒high0.145
1080P4 秒high0.1725
1080P5 秒high0.2
1080P6 秒high0.2275
1080P7 秒high0.255
1080P8 秒high0.2825
1080P9 秒high0.31
1080P10 秒high0.3375
1080P11 秒high0.365
1080P12 秒high0.3925
1080P13 秒high0.42
1080P14 秒high0.4475
1080P15 秒high0.475
2K3 秒low0.1182
2K4 秒low0.1575
2K5 秒low0.1969
2K6 秒low0.2363
2K7 秒low0.2757
2K8 秒low0.315
2K9 秒low0.3544
2K10 秒low0.3938
2K11 秒low0.4332
2K12 秒low0.4725
2K13 秒low0.5119
2K14 秒low0.5513
2K15 秒low0.5907
2K3 秒high0.1807
2K4 秒high0.22
2K5 秒high0.2594
2K6 秒high0.2988
2K7 秒high0.3382
2K8 秒high0.3775
2K9 秒high0.4169
2K10 秒high0.4563
2K11 秒high0.4957
2K12 秒high0.535
2K13 秒high0.5744
2K14 秒high0.6138
2K15 秒high0.6532
4K3 秒low0.2532
4K4 秒low0.3375
4K5 秒low0.4219
4K6 秒low0.5063
4K7 秒low0.5907
4K8 秒low0.675
4K9 秒low0.7594
4K10 秒low0.8438
4K11 秒low0.9282
4K12 秒low1.0125
4K13 秒low1.0969
4K14 秒low1.1813
4K15 秒low1.2657
4K3 秒high0.3157
4K4 秒high0.4
4K5 秒high0.4844
4K6 秒high0.5688
4K7 秒high0.6532
4K8 秒high0.7375
4K9 秒high0.8219
4K10 秒high0.9063
4K11 秒high0.9907
4K12 秒high1.075
4K13 秒high1.1594
4K14 秒high1.2438
4K15 秒high1.3282

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

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

默认配置：每次 0.1969 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，不返回内部调用信息。