MiniMax H3 Lite Reference-to-Video
minimax/h3-lite/reference-to-video
minimax/h3-lite/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
Mô hình liên quan
Đầy đủ tham số, lược đồ đầu ra và giá hiện tại
| Chợ API mô hình AI | Một nền tảng cho mọi thứ | Phổ biến nhất | Điều khoản | Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất. |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | |
| reference_imagesReference Images | image_upload | — | image/* · 0–9 items | |
| reference_audiosReference Audios | video_upload_group | — | audio/* · 0–3 items | |
| aspect_ratioAspect Ratio | select | 16:9 | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | |
| resolutionResolution | select | 768p | 768p | 480p | |
| durationDuration | select | 5 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | … |
Đầy đủ tham số, lược đồ đầu ra và giá hiện tại
| Tìm hiểu thêm | Một nền tảng cho mọi thứ | Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất. |
|---|---|---|
| videos | array<string> |
API
Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
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);Tài liệu API
MiniMax H3 Lite Reference-to-Video
Generate videos with native audio, 4–15 second durations, and 480p or 768p resolution.
Inputs
| Parameter | Required | Type / limits / default |
|---|---|---|
prompt | Yes | string; 1–5000 characters. Text description of the desired video scene and interactions. |
reference_images | No | array; max 9. Up to 9 reference image URLs. At least one reference image or video is required. Images must be 256-5760 pixels per side, with a width-to-height ratio of 0.4-2.5. |
reference_videos | No | array; max 3. Up to 3 reference video URLs. Clips are adjusted to 2-15 seconds each, with a combined maximum of 15 seconds; longer clips are trimmed and shorter clips are extended. Use MP4 or MOV, up to 50 MB per file, 256-5760 pixels per side, width-to-height ratio 0.4-2.5, and 23.976-60 FPS. At least one image or video is required. |
reference_audios | No | array; max 3. Up to 3 optional WAV or MP3 reference audio URLs, up to 15 MB per file. Each clip must be 2-15 seconds, with a combined maximum of 15 seconds. Audio is not automatically trimmed and cannot be provided alone. |
aspect_ratio | No | string; 21:9, 16:9, 4:3, 1:1, 3:4, 9:16; default: 16:9. Output aspect ratio. |
resolution | No | string; 768p, 480p; default: 768p. Output video resolution. |
duration | No | integer; 4–15; 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15; default: 5. Output video duration in seconds. |
Prompt must be non-empty. This endpoint accepts up to 5000 characters to match the current MaaS input contract (WaveSpeed supports up to 7000).
Provide at least one reference image or video; audio cannot be the only input. Images: 256–5760 pixels per side, aspect ratio 0.4–2.5. Videos: MP4/MOV, at most 50 MB each, 23.976–60 FPS, 256–5760 pixels per side, aspect ratio 0.4–2.5. Reference audio: WAV/MP3, at most 15 MB each, 2–15 seconds per clip and at most 15 seconds combined; audio is not automatically trimmed.
Listing price
| Resolution | USD / second | Credits / second |
|---|---|---|
| 480p | $0.025 | 2.5 |
| 768p | $0.04 | 4 |
Account discounts are applied separately. 1 USD = 100 credits. Generated audio has no extra charge.
Current charge = rate × (output seconds + ceil(min(sum of reference-video seconds, 15))) + $0.02 × max(reference image count − 5, 0). First 5 reference images and reference audio are free.
API example
Replace example URLs with uploaded media. Submit once, then poll task_uuid until completed or failed. Successful output.videos is an array of video URLs. Image and last_image accept one-element arrays; Nami forwards each as a single upstream 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
Mô hình liên quan
xAI Grok Imagine Video v1.5 Reference to Video
x-ai/grok-imagine-video-v1.5/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
Vidu Q4 Preview Reference to Video
vidu/q4-preview/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
MiniMax H3 Reference to Video
minimax/h3/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
MiniMax H3 Singularity Reference-to-Video LoRA
minimax-h3-singularity/reference-to-video-lora. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
MiniMax H3 Singularity Reference-to-Video
minimax-h3-singularity/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
Kling 4.0 Reference to Video
kwaivgi/kling-v4.0/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
Gemini Omni Flash Reference to Video API
google/gemini-omni-flash/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.
Seedance 2.0 Mini Reference to Video
doubao/seedance-2.0-mini/reference-to-video. Duyệt API mô hình ảnh, video và đổi khuôn mặt. Thử mô hình rồi tích hợp qua một API REST thống nhất.