如何使用 MiniMax H3 Highspeed 参考生视频 API：参考图生视频接入指南（2026）
MiniMax H3 Highspeed 参考生视频 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
MiniMax H3 Highspeed 参考生视频 是一款参考图生视频模型（由 Minimax 提供）：生成 4–15 秒、768p 的视频。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.300。
TL;DR
· 任务类型：参考图生视频，由 Minimax 提供
· 价格：典型一次调用约 $0.300（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：6 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 MiniMax H3 Highspeed 参考生视频 能做什么？
短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。
社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。
已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。
怎么调用这个 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-highspeed/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 Highspeed 参考生视频 的提示词怎么写？
- 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
- 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
- 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。
价格是多少？
按次积分计价，典型一次调用约 $0.300（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
MiniMax H3 Highspeed 参考生视频
生成 4–15 秒、768p 的视频。
输入参数
| Parameter | 必填 | 类型、可选值、默认值 |
|---|---|---|
prompt | 必填 | string; max 5000 characters. 描述目标视频场景和互动内容的文本。 |
reference_images | 可选 | array; max count: 9. 最多可填写 9 个参考图片 URL。至少需要提供 1 个参考图片或参考视频。图片单边尺寸需为 256–5760 像素，宽高比需在 0.4–2.5 之间。 |
reference_videos | 可选 | array; max count: 3. 最多可填写 3 个参考视频 URL。每段视频会调整为 2–15 秒，总时长最长 15 秒；过长的视频会被裁剪，过短的视频会被补足。支持 MP4 或 MOV，每个文件最大 50 MB，单边尺寸为 256–5760 像素，宽高比为 0.4–2.5，帧率为 23.976–60 FPS。至少需要提供 1 个图片或视频。 |
reference_audios | 可选 | array; max count: 3. 最多可填写 3 个可选的 WAV 或 MP3 参考音频 URL，每个文件最大 15 MB。每段音频需为 2–15 秒，总时长最长 15 秒。音频不会自动裁剪，且不能单独提供。 |
aspect_ratio | 可选 | string; 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16; default: "16:9". 输出视频的宽高比。 |
resolution | 可选 | string; 768p; default: "768p". 输出视频分辨率。 |
duration | 可选 | integer; 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15; default: 5. 输出视频时长（秒）。 |
Nami 按当前 MaaS 接口约束接收最多 5000 字符的提示词；必填提示词不能为空。
至少提供一张参考图或一个参考视频，不能只提供音频。最多 9 张图片、3 段视频、3 段音频。图片和视频画面每边 256–5760 像素，宽高比 0.4–2.5。视频使用 MP4/MOV，每个不超过 50 MB，23.976–60 FPS；参考视频逐段调整为 2–15 秒，合计最多 15 秒。参考音频使用 WAV/MP3，每个不超过 15 MB，每段 2–15 秒，合计最多 15 秒，不自动裁剪。
标准价
1 美元 = 100 积分，账户折扣另算。
768p：输出视频每秒 $0.06（6 积分）。输出时长为 4–15 整秒，默认 5 秒。
参考视频费用：$0.06 × ceil(min(各段参考视频至少按 2 秒计入后的总秒数, 15))。前 5 张参考图片免费，每多一张 $0.03（3 积分）；参考音频免费。
接口调用
请使用可访问的素材 URL。仅提交一次，再用 task_uuid 查询至 completed 或 failed；成功结果 output.videos 为视频 URL 数组。
POST https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"resolution": "768p",
"prompt": "A colorful scene with gentle natural movement.",
"duration": 5,
"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
常见问题
可以先免费试用吗？+
注册赠送积分仅可用于指定模型，适用范围会持续更新；Playground 提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。
MiniMax H3 Highspeed 参考生视频 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。