如何使用 MiniMax H3 Lite 参考生视频 API：参考图生视频接入指南（2026）

2 min · 更新于 2026-07-11 · NamiFusion 团队

MiniMax H3 Lite 参考生视频 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。

MiniMax H3 Lite 参考生视频是一款参考图生视频模型（由 Minimax 提供）：生成带原生音频的视频，支持 4–15 秒、480p 或 768p。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.200。

TL;DR

· 任务类型：参考图生视频，由 Minimax 提供

· 价格：典型一次调用约 $0.200（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：6 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 MiniMax H3 Lite 参考生视频能做什么？

短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。

产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。

社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。

已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。

怎么调用这个 API？

在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
用返回的 task_uuid 轮询任务状态，完成后取输出 URL。

提交任务

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-lite/reference-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration": 5
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

有哪些参数？

prompt（提示词）：必填

reference_images（参考图片）：可选

reference_audios（参考音频）：可选

aspect_ratio（宽高比）：可选，默认 "16:9"

resolution（分辨率）：可选，默认 "768p"

duration（时长）：可选，默认 5

MiniMax H3 Lite 参考生视频的提示词怎么写？

主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价，典型一次调用约 $0.200（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。

MiniMax H3 Lite 参考生视频

生成带原生音频的视频，支持 4–15 秒、480p 或 768p。

输入参数

Parameter	必填	类型、范围、默认值
`prompt`	Yes	string; 1–5000 characters. 描述目标视频场景和互动内容的文本。
`reference_images`	No	array; max 9. 最多可提供 9 个参考图片 URL。至少需要提供 1 张参考图片或 1 个参考视频。图片每边尺寸需为 256-5760 像素，宽高比需在 0.4-2.5 之间。
`reference_videos`	No	array; max 3. 最多可提供 3 个参考视频 URL。每段视频会调整为 2-15 秒，总时长最长 15 秒；过长的视频会被裁剪，过短的视频会被延长。支持 MP4 或 MOV，每个文件最大 50 MB，每边尺寸需为 256-5760 像素，宽高比需在 0.4-2.5 之间，帧率为 23.976-60 FPS。至少需要提供 1 张图片或 1 个视频。
`reference_audios`	No	array; max 3. 最多可提供 3 个可选的 WAV 或 MP3 参考音频 URL，每个文件最大 15 MB。每段音频需为 2-15 秒，总时长最长 15 秒。音频不会自动裁剪，且不能单独提供。
`aspect_ratio`	No	string; 21:9, 16:9, 4:3, 1:1, 3:4, 9:16; default: 16:9. 输出视频的宽高比。
`resolution`	No	string; 768p, 480p; default: 768p. 输出视频分辨率。
`duration`	No	integer; 4–15; 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15; default: 5. 输出视频时长（秒）。

提示词不能为空。本接口按当前 MaaS 参数约束接收最多 5000 字符（WaveSpeed 本身支持最多 7000 字符）。

至少提供一张参考图片或一个参考视频，不能只提供音频。图片：每边 256–5760 像素、宽高比 0.4–2.5。视频：MP4/MOV，每个不超过 50 MB，23.976–60 FPS，每边 256–5760 像素，宽高比 0.4–2.5。参考音频：WAV/MP3，每个不超过 15 MB，每段 2–15 秒、合计不超过 15 秒；音频不会自动裁剪。

标准价

Resolution	USD / second	Credits / second
480p	$0.025	2.5
768p	$0.04	4

账户折扣另算。1 美元 = 100 积分。生成音频不另收费。

当前费用 = 秒价 ×（输出秒数 + ceil(min(各段参考视频至少按 2 秒计入后的总秒数, 15))）+ $0.02 × max(参考图片数 − 5, 0)。前 5 张参考图及参考音频免费。

API 示例

请替换为已上传的素材 URL。提交一次后使用 task_uuid 查询至 completed 或 failed；成功结果 output.videos 为视频 URL 数组。image 和 last_image 接收单元素数组，Nami 转为上游单个 URL。

POST https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-lite/reference-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json

{
  "input": {
    "prompt": "Colorful shapes move gently through the scene.",
    "duration": 5,
    "resolution": "768p",
    "reference_images": [
      "https://example.com/subject.png"
    ],
    "aspect_ratio": "16:9"
  }
}

GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY

WaveSpeed

完整参数表、输出字段与实时价格 →

常见问题

可以先免费试用吗？+

注册赠送积分仅可用于指定模型，适用范围会持续更新；Playground 提交前会显示准确报价。

生成内容可以商用吗？有水印吗？+

可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。

内容政策是什么？+

色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。

MiniMax H3 Lite 参考生视频的任务要跑多久？+

取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。

分辨率/时长上限是多少？+

以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。

免费试用 →