MiniMax H3 Singularity 参考生视频
minimax-h3-singularity/reference-to-video
生成带原生立体声音频的视频,支持 3–15 秒时长和四档分辨率。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | — | 对目标视频的文字描述。可将参考输入写作 <Picture 1>..<Picture 9>、<Video 1>..<Video 3> 和 <Audio 1>..<Audio 3>。音频会与视频一同原生生成。 |
| reference_images参考图片 | image_upload | — | image/* · 0–9 items | 参考图片 URL(最多 9 张)。至少需要一个参考输入。 |
| reference_audios参考音频 | audio_upload_group | — | audio/* · 0–3 items | 独立参考音频 URL(最多 3 段,每段会裁剪为 15 秒)。 |
| aspect_ratio宽高比 | select | 16:9 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | 9:21 | 输出视频的宽高比。 |
| resolution分辨率 | select | 480p | 480p | 540p | 768p | 1080p | 输出视频分辨率。768p 是模型的原生画布;480p 生成更快、成本更低;540p 为中档规格,价格为 480p 的 1.5 倍。1080p 为最高质量的全高清档位,价格为 768p 的 2 倍(生成时间更长)。 |
| duration时长 | select | 5 | 3 ~ 15 · step 1 · 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | … | 输出视频的时长(秒)。 |
| seed随机种子 | number | — | step 1 | 用于生成的随机种子。-1 表示使用随机种子。 |
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 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-singularity/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": "480p",
"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-singularity/reference-to-video",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"aspect_ratio": "16:9",
"resolution": "480p",
"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-singularity/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": "480p",
"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 Singularity 参考生视频
使用参考素材生成带原生立体声音频的视频。
输入参数
| 参数 | 必填 | 类型、范围与默认值 |
|---|---|---|
prompt | 是 | 描述动作、场景和声音。 |
reference_images | 否 | array;最多 9 个图片 URL。 |
reference_videos | 否 | array;最多 3 个视频 URL;参考视频总时长最多使用 15 秒,自动使用其音轨。 |
reference_audios | 否 | array;最多 3 个音频 URL;每段最多使用 15 秒。 |
aspect_ratio | 否 | string; 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / 9:21; default: 16:9 |
resolution | 否 | string; 480p / 540p / 768p / 1080p; default: 480p |
duration | 否 | integer; 3–15; default: 5 |
seed | 否 | integer; -1 = random |
至少提供一个参考输入。在提示词中使用 <Picture 1>、<Video 1>、<Audio 1>,编号对应各数组顺序。
标准价
| Resolution | USD / second | Credits / second |
|---|---|---|
| 480p | $0.05 | 5 |
| 540p | $0.075 | 7.5 |
| 768p | $0.1 | 10 |
| 1080p | $0.2 | 20 |
以下为美元原价,账户折扣另算;1 美元 = 100 积分。参考视频与输出视频按相同秒价收费;每张参考图片、每段独立参考音频另收 $0.02(2 积分)。参考视频总时长先合计、封顶 15 秒,再向上取整到整秒。
费用 = 秒价 ×(输出秒数 + ceil(min(参考视频总秒数, 15)))+ $0.02 ×(参考图片数 + 独立参考音频数)。
Nami 最终积分向上取整至 0.01 积分;原生生成的音频不另收费。
API 示例
请将示例素材 URL 替换为已上传的素材。只提交一次,再用返回的 task_uuid 查询;不要自动重试提交请求。
POST https://www.namifusion.com/api/v1/marketplace/run/minimax-h3-singularity/reference-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"prompt": "Animate the subject from <Picture 1> with a slow camera move and ambient sound.",
"duration": 5,
"resolution": "480p",
"reference_images": [
"https://example.com/subject.png"
]
}
}
GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
提交成功返回 task_uuid 和 status。查询至 completed 或 failed;成功结果的 output.videos 为视频 URL 数组。
相关模型
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。
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,性能卓越,告别冷启动,是极具性价比的专业视频创作利器
Seedance 2.5 参考图/视频转视频
Seedance 2.5 的“参考生视频”功能是视觉统一的终极方案。它能精准提取参考素材的艺术风格、光影基调或构图意向,并将其完美融入新生成的视频中,确保您的系列创作拥有高度一致的视觉语言。
Seedance 2.0 Fast 视频编辑
Seedance 2.0 Fast(reference-to-video)可根据自然语言提示词对输入视频进行编辑,速度更快、成本更低。基于字节跳动 Seed 统一多模态架构构建,在按指令重写光照、风格、天气、环境或特定元素的同时,保留主体身份、构图和运动。提供开箱即用的 REST API,性能出色,无冷启动,价格实惠。