MiniMax H3 Singularity Reference-to-Video
minimax-h3-singularity/reference-to-video
minimax-h3-singularity/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
관련 모델
전체 매개변수, 출력 스키마 및 실시간 요금
| AI 모델 API 마켓 | 하나의 플랫폼, 모든 기능 | 가장 인기 | 이용약관 | 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다. |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | — | |
| reference_imagesReference Images | image_upload | — | image/* · 0–9 items | |
| reference_audiosReference Audios | audio_upload_group | — | audio/* · 0–3 items | |
| aspect_ratioAspect Ratio | select | 16:9 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | 9:21 | |
| resolutionResolution | select | 480p | 480p | 540p | 768p | 1080p | |
| durationDuration | select | 5 | 3 ~ 15 · step 1 · 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | … | |
| seedSeed | number | — | step 1 |
전체 매개변수, 출력 스키마 및 실시간 요금
| 자세히 보기 | 하나의 플랫폼, 모든 기능 | 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다. |
|---|---|---|
| videos | array<string> |
API
이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
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);API 문서
MiniMax H3 Singularity Reference-to-Video
Create a video with native stereo audio from reference media.
Inputs
| Parameter | Required | Type / limits / default |
|---|---|---|
prompt | Yes | Motion, scene and sound instructions. |
reference_images | No | array; at most 9 image URLs. |
reference_videos | No | array; at most 3 video URLs; combined reference duration capped at 15 seconds; soundtracks are used. |
reference_audios | No | array; at most 3 audio URLs; each audio is trimmed to 15 seconds. |
aspect_ratio | No | string; 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / 9:21; default: 16:9 |
resolution | No | string; 480p / 540p / 768p / 1080p; default: 480p |
duration | No | integer; 3–15; default: 5 |
seed | No | integer; -1 = random |
Provide at least one reference input. Use <Picture 1>, <Video 1> and <Audio 1> tags in the prompt; numbering follows each array.
Listing price
| Resolution | USD / second | Credits / second |
|---|---|---|
| 480p | $0.05 | 5 |
| 540p | $0.075 | 7.5 |
| 768p | $0.1 | 10 |
| 1080p | $0.2 | 20 |
USD list prices before account discounts; 1 USD = 100 credits. Reference videos use the same per-second rate as output video. Add $0.02 (2 credits) per reference image and per standalone audio. Sum all reference-video durations, cap at 15 seconds, then round up to whole seconds.
Charge = rate × (output seconds + ceil(min(total reference-video seconds, 15))) + $0.02 × (image count + standalone audio count).
Nami rounds the final credit amount upward to 0.01 credit. Native generated audio has no separate charge.
API example
Replace the example media URL with your uploaded asset. Submit once, then poll the returned task_uuid; do not automatically retry submission.
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
Successful submission returns task_uuid and status. Query the task until completed or failed; successful output.videos contains the generated video URLs.
관련 모델
xAI Grok Imagine Video v1.5 Reference to Video
x-ai/grok-imagine-video-v1.5/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
Vidu Q4 Preview Reference to Video
vidu/q4-preview/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
MiniMax H3 Reference to Video
minimax/h3/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
MiniMax H3 Singularity Reference-to-Video LoRA
minimax-h3-singularity/reference-to-video-lora. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
Gemini Omni Flash Reference to Video API
google/gemini-omni-flash/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
Seedance 2.0 Mini Reference to Video
doubao/seedance-2.0-mini/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
Seedance 2.5 Reference to Video
doubao/seedance-2-5/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
Seedance 2.0 Fast reference-to-video
doubao/seedance-2-0-fast/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.