Docs / video / MiniMax H3 Image to Video
MiniMax H3 Image to Video online
Animate a still image with MiniMax H3 — set a start frame, an optional end frame, and let the model fill the motion.
Rp Mulai Rp5.176 / video
minimax-h3/image-to-video model id
1 · Create a task
Kirim permintaan untuk membuat tugas generasi video. Wajib header Idempotency-Key. Saldo direservasi sebesar estimasi; task gagal tidak ditagih.
curl -X POST https://getrun.id/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: my-task-001" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3/image-to-video",
"input": {
"prompt": "Use Image 1 as the exact opening frame and Image 2 as the exact ending frame. Create a 12-second architectural brand reveal that transforms the closed pavilion into the fully opened MiniMax H3 API and Kie.ai exhibition.\n[0–3 seconds]\nHold the opening composition almost still. Let reflections shift subtly across the frosted glass while the exterior architectural lights turn on section by section. Keep “MiniMax H3 API” and “Kie.ai” readable and unchanged.\n[3–7 seconds]\nThe central doors begin opening slowly and symmetrically. Warm interior light appears through the widening gap and travels across the plaza. Introduce gentle camera movement by pushing forward only slightly; do not change the original frontal alignment.\n[7–10 seconds]\nAs the doors open wider, the interior fabric installations move softly from indoor airflow. Sculptural panels slide into alignment and reveal portions of the final sentence in a controlled sequence. Do not replace the architecture or invent a different interior.\n[10–12 seconds]\nArrive precisely at Image 2. The full line “MiniMax H3 API is now available on Kie.ai” becomes completely visible and stable. Hold the ending frame with only subtle fabric movement and light reflections.\nAudio: quiet city ambience, low architectural room tone, soft mechanical door movement, subtle fabric sounds, and one refined musical swell as the final line is revealed.\nPreserve the building geometry, camera position, text spelling, plaza layout, lighting direction, and all core visual elements. No people, hard cuts, rapid zooms, morphing architecture, floating UI, extra text, misspellings, glowing cyber effects, or camera rotation.",
"resolution": "2K"
}
}'const res = await fetch('https://getrun.id/v1/tasks', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Idempotency-Key': 'my-task-001',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "minimax-h3/image-to-video",
"input": {
"prompt": "Use Image 1 as the exact opening frame and Image 2 as the exact ending frame. Create a 12-second architectural brand reveal that transforms the closed pavilion into the fully opened MiniMax H3 API and Kie.ai exhibition.\n[0–3 seconds]\nHold the opening composition almost still. Let reflections shift subtly across the frosted glass while the exterior architectural lights turn on section by section. Keep “MiniMax H3 API” and “Kie.ai” readable and unchanged.\n[3–7 seconds]\nThe central doors begin opening slowly and symmetrically. Warm interior light appears through the widening gap and travels across the plaza. Introduce gentle camera movement by pushing forward only slightly; do not change the original frontal alignment.\n[7–10 seconds]\nAs the doors open wider, the interior fabric installations move softly from indoor airflow. Sculptural panels slide into alignment and reveal portions of the final sentence in a controlled sequence. Do not replace the architecture or invent a different interior.\n[10–12 seconds]\nArrive precisely at Image 2. The full line “MiniMax H3 API is now available on Kie.ai” becomes completely visible and stable. Hold the ending frame with only subtle fabric movement and light reflections.\nAudio: quiet city ambience, low architectural room tone, soft mechanical door movement, subtle fabric sounds, and one refined musical swell as the final line is revealed.\nPreserve the building geometry, camera position, text spelling, plaza layout, lighting direction, and all core visual elements. No people, hard cuts, rapid zooms, morphing architecture, floating UI, extra text, misspellings, glowing cyber effects, or camera rotation.",
"resolution": "2K"
}
}),
});
const task = await res.json();import requests
res = requests.post(
"https://getrun.id/v1/tasks",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Idempotency-Key": "my-task-001",
},
json={
"model": "minimax-h3/image-to-video",
"input": {
"prompt": "Use Image 1 as the exact opening frame and Image 2 as the exact ending frame. Create a 12-second architectural brand reveal that transforms the closed pavilion into the fully opened MiniMax H3 API and Kie.ai exhibition.\n[0–3 seconds]\nHold the opening composition almost still. Let reflections shift subtly across the frosted glass while the exterior architectural lights turn on section by section. Keep “MiniMax H3 API” and “Kie.ai” readable and unchanged.\n[3–7 seconds]\nThe central doors begin opening slowly and symmetrically. Warm interior light appears through the widening gap and travels across the plaza. Introduce gentle camera movement by pushing forward only slightly; do not change the original frontal alignment.\n[7–10 seconds]\nAs the doors open wider, the interior fabric installations move softly from indoor airflow. Sculptural panels slide into alignment and reveal portions of the final sentence in a controlled sequence. Do not replace the architecture or invent a different interior.\n[10–12 seconds]\nArrive precisely at Image 2. The full line “MiniMax H3 API is now available on Kie.ai” becomes completely visible and stable. Hold the ending frame with only subtle fabric movement and light reflections.\nAudio: quiet city ambience, low architectural room tone, soft mechanical door movement, subtle fabric sounds, and one refined musical swell as the final line is revealed.\nPreserve the building geometry, camera position, text spelling, plaza layout, lighting direction, and all core visual elements. No people, hard cuts, rapid zooms, morphing architecture, floating UI, extra text, misspellings, glowing cyber effects, or camera rotation.",
"resolution": "2K"
}
},
)
task = res.json()Input parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
prompt |
string | Yes | Video description prompt (max 7000 chars) | Use Image 1 as the exact opening frame and Ima |
duration |
integer | Yes | Video duration in seconds. Available values: 4-15. (min 4, max 15) | 12 |
resolution |
string | No | Video resolution. Opsi: 768P 2K |
2K |
last_frame_url |
string | No | End frame image (file URL) | — |
first_frame_url |
string | No | Start frame image (file URL) | — |
2 · Poll the result
Ambil status tugas hingga selesai — poll tiap 2–5 detik.
Respons saat sukses:
{
"id": "task_9f2c…",
"status": "succeeded",
"model": "minimax-h3/image-to-video",
"price": {
"currency": "IDR",
"estimated": 5176,
"reserved": 5176,
"final": 5176
},
"output": {
"urls": [
"https://storage.getcore.id/outputs/task_9f2c…/0.mp4"
],
"expires_at": "(7 hari setelah selesai)"
}
}
Status values
| Status | Keterangan |
|---|---|
queued | Tugas sedang diantrikan. |
processing | Sedang diproses. |
succeeded | Berhasil. |
failed | Gagal — lihat error detail, tidak ditagih. |
video/mp4, dilayani dari CDN kami dan berlaku 7 hari — salin ke penyimpananmu sendiri untuk jangka panjang.Best practices
Bila generation gagal, task berstatus failed dengan error.code ternormalisasi (mis. moderation_blocked, upstream_error) dan price.final = 0 — saldo dikembalikan otomatis. Daftar lengkap kode error ada di Error handling. Selalu kirim Idempotency-Key unik per tugas agar retry aman.
Coba tanpa kode: jalankan model ini langsung dari Playground atau lihat di API Market.
