MiniMax H3 Highspeed 参考生视频
minimax/h3-highspeed/reference-to-video
生成 4–15 秒、768p 的视频。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | ≤ 5000 chars | 描述目标视频场景和互动内容的文本。 |
| reference_images参考图片 | image_upload | — | image/* · 0–9 items | 最多可填写 9 个参考图片 URL。至少需要提供 1 个参考图片或参考视频。图片单边尺寸需为 256–5760 像素,宽高比需在 0.4–2.5 之间。 |
| reference_audios参考音频 | audio_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 | 输出视频分辨率。 |
| 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-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"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-highspeed/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-highspeed/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 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
相关模型
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 Lite 参考生视频
生成带原生音频的视频,支持 4–15 秒、480p 或 768p。
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,性能出色,无冷启动,价格实惠。