MiniMax H3 Lite 参考生视频
minimax/h3-lite/reference-to-video
生成带原生音频的视频,支持 4–15 秒、480p 或 768p。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | ≤ 5000 chars | 描述目标视频场景和互动内容的文本。 |
| reference_images参考图片 | image_upload | — | image/* · 0–9 items | 最多可提供 9 个参考图片 URL。至少需要提供 1 张参考图片或 1 个参考视频。图片每边尺寸需为 256-5760 像素,宽高比需在 0.4-2.5 之间。 |
| reference_audios参考音频 | video_upload_group | — | audio/* · 0–3 items | 最多可提供 3 个可选的 WAV 或 MP3 参考音频 URL,每个文件最大 15 MB。每段音频需为 2-15 秒,总时长最长 15 秒。音频不会自动裁剪,且不能单独提供。 |
| aspect_ratio宽高比 | select | 16:9 | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 输出视频的宽高比。 |
| resolution分辨率 | select | 768p | 768p | 480p | 输出视频分辨率。 |
| duration时长 | select | 5 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | … | 输出视频时长(秒)。 |
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| videos | array<string> |
API
通过统一 REST API 调用本模型;在 API Keys 页获取密钥。
cURL
# 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"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-lite/reference-to-video",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "16:9",
"resolution": "768p",
"duration": 5
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-lite/reference-to-video", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "16:9",
"resolution": "768p",
"duration": 5
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);文档
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
相关模型
xAI Grok Imagine Video v1.5 参考图转视频
使用提示词和 1-7 张参考图片生成 1-15 秒视频,支持 480p 和 720p。
Vidu Q4 Preview 参考生视频
根据提示词生成 3~16 秒视频,可选最多 15 张参考图片和 3 段参考音频,支持宽高比选择、音频生成及 540p~4k 分辨率。
MiniMax H3 参考图生视频
MiniMax H3 Reference to Video 可根据自然语言提示词和多模态参考内容生成连贯的 2K 视频,支持图片、视频和音频输入,可引导主体一致性、运动、时序、视觉风格和场景连贯性。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
MiniMax H3 Singularity 参考生视频 LoRA
生成带原生立体声音频的视频,支持 3–15 秒时长和四档分辨率。支持自定义 LoRA。
MiniMax H3 Singularity 参考生视频
生成带原生立体声音频的视频,支持 3–15 秒时长和四档分辨率。
可灵 4.0 参考生视频
使用图片、视频和音频参考生成 3–30 秒视频,支持提示词引用及 720p、1080p。
Gemini Omni Flash 参考图生视频 API
Gemini Omni Flash 参考图生视频可根据一张或多张参考图片和文本提示词生成带同步音频的短视频,保持视觉主体一致性,并依据提供的参考内容进行引导式多模态视频生成。即开即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
Seedance 2.0 Mini 参考生视频
Seedance 2.0 Mini 参考图生视频 (Reference-to-Video) 是字节跳动推出的一款高速度、低成本的视频生成模型,专注于创作具有电影质感的多镜头视频。该模型能够完美融合参考图与文本提示词,生成极具叙事感的连续视频片段。它不仅支持灵动的 AI 镜头控制,更攻克了跨场景角色一致性的难题。模型支持从 480P 到 4K 的多分辨率输出,时长跨越 4-15 秒,并适配灵活的宽高比。提供开箱即用的 REST 推理 API,性能卓越,告别冷启动,是极具性价比的专业视频创作利器