Docs / video / MiniMax H3 Text to Video
MiniMax H3 Text to Video online
MiniMax's H3 video model — cinematic motion and strong prompt adherence at 768P or 2K.
Rp Mulai Rp5.176 / video
minimax-h3/text-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/text-to-video",
"input": {
"prompt": "Create a 15-second cinematic contemporary-dance scene in a quiet historic courtyard shortly after rainfall. The courtyard has pale stone arches, weathered columns, shallow puddles, and soft reflections across the wet ground. A young woman stands alone in the center wearing a flowing dark red midi dress with long sleeves and simple black dance shoes. Preserve her face, hairstyle, clothing, and body proportions throughout the entire performance.\n[0–3 seconds]\nBegin in a restrained medium-wide shot from behind. The dancer stands completely still while water drips from the surrounding arches. A soft piano note begins. She slowly turns her head, then rotates her shoulders and body toward the camera with controlled natural movement.\n[3–7 seconds]\nShe begins a contemporary dance phrase with one extended arm, a grounded step forward, a low turn, and a smooth recovery into an upright pose. Her dress follows the movement with believable weight and delayed fabric motion. Keep both feet connected naturally to the wet stone surface without sliding.\n[7–11 seconds]\nThe rhythm becomes stronger. Track laterally as she performs two connected turns, opens both arms, lowers briefly through the knees, and rises into a longer traveling movement across the courtyard. Her reflection should remain aligned with her position and motion in the puddles.\n[11–15 seconds]\nMove slightly closer as she completes one final controlled rotation and stops in a stable pose with one arm raised and the other lowered. The music cuts to a quiet sustained note. Hold the final posture while fabric and loose hair settle naturally and rain continues dripping in the background.\nCamera: measured dolly movement, restrained lateral tracking, natural perspective, no rapid orbiting or abrupt zooms.\nLighting: soft overcast daylight with subtle warm reflections from the surrounding stone.\nAudio: original minimal piano and low strings, light rainfall, fabric movement, footsteps on wet stone, and natural courtyard ambience.\nMaintain realistic anatomy, continuous choreography, stable facial identity, accurate hand and foot placement, and physically believable clothing motion.\nNo extra dancers, cuts to unrelated locations, duplicated limbs, distorted hands, floating feet, sudden costume changes, exaggerated acrobatics, theatrical facial expressions, subtitles, text, or logos.",
"resolution": "2K",
"aspect_ratio": "21:9"
}
}'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/text-to-video",
"input": {
"prompt": "Create a 15-second cinematic contemporary-dance scene in a quiet historic courtyard shortly after rainfall. The courtyard has pale stone arches, weathered columns, shallow puddles, and soft reflections across the wet ground. A young woman stands alone in the center wearing a flowing dark red midi dress with long sleeves and simple black dance shoes. Preserve her face, hairstyle, clothing, and body proportions throughout the entire performance.\n[0–3 seconds]\nBegin in a restrained medium-wide shot from behind. The dancer stands completely still while water drips from the surrounding arches. A soft piano note begins. She slowly turns her head, then rotates her shoulders and body toward the camera with controlled natural movement.\n[3–7 seconds]\nShe begins a contemporary dance phrase with one extended arm, a grounded step forward, a low turn, and a smooth recovery into an upright pose. Her dress follows the movement with believable weight and delayed fabric motion. Keep both feet connected naturally to the wet stone surface without sliding.\n[7–11 seconds]\nThe rhythm becomes stronger. Track laterally as she performs two connected turns, opens both arms, lowers briefly through the knees, and rises into a longer traveling movement across the courtyard. Her reflection should remain aligned with her position and motion in the puddles.\n[11–15 seconds]\nMove slightly closer as she completes one final controlled rotation and stops in a stable pose with one arm raised and the other lowered. The music cuts to a quiet sustained note. Hold the final posture while fabric and loose hair settle naturally and rain continues dripping in the background.\nCamera: measured dolly movement, restrained lateral tracking, natural perspective, no rapid orbiting or abrupt zooms.\nLighting: soft overcast daylight with subtle warm reflections from the surrounding stone.\nAudio: original minimal piano and low strings, light rainfall, fabric movement, footsteps on wet stone, and natural courtyard ambience.\nMaintain realistic anatomy, continuous choreography, stable facial identity, accurate hand and foot placement, and physically believable clothing motion.\nNo extra dancers, cuts to unrelated locations, duplicated limbs, distorted hands, floating feet, sudden costume changes, exaggerated acrobatics, theatrical facial expressions, subtitles, text, or logos.",
"resolution": "2K",
"aspect_ratio": "21:9"
}
}),
});
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/text-to-video",
"input": {
"prompt": "Create a 15-second cinematic contemporary-dance scene in a quiet historic courtyard shortly after rainfall. The courtyard has pale stone arches, weathered columns, shallow puddles, and soft reflections across the wet ground. A young woman stands alone in the center wearing a flowing dark red midi dress with long sleeves and simple black dance shoes. Preserve her face, hairstyle, clothing, and body proportions throughout the entire performance.\n[0–3 seconds]\nBegin in a restrained medium-wide shot from behind. The dancer stands completely still while water drips from the surrounding arches. A soft piano note begins. She slowly turns her head, then rotates her shoulders and body toward the camera with controlled natural movement.\n[3–7 seconds]\nShe begins a contemporary dance phrase with one extended arm, a grounded step forward, a low turn, and a smooth recovery into an upright pose. Her dress follows the movement with believable weight and delayed fabric motion. Keep both feet connected naturally to the wet stone surface without sliding.\n[7–11 seconds]\nThe rhythm becomes stronger. Track laterally as she performs two connected turns, opens both arms, lowers briefly through the knees, and rises into a longer traveling movement across the courtyard. Her reflection should remain aligned with her position and motion in the puddles.\n[11–15 seconds]\nMove slightly closer as she completes one final controlled rotation and stops in a stable pose with one arm raised and the other lowered. The music cuts to a quiet sustained note. Hold the final posture while fabric and loose hair settle naturally and rain continues dripping in the background.\nCamera: measured dolly movement, restrained lateral tracking, natural perspective, no rapid orbiting or abrupt zooms.\nLighting: soft overcast daylight with subtle warm reflections from the surrounding stone.\nAudio: original minimal piano and low strings, light rainfall, fabric movement, footsteps on wet stone, and natural courtyard ambience.\nMaintain realistic anatomy, continuous choreography, stable facial identity, accurate hand and foot placement, and physically believable clothing motion.\nNo extra dancers, cuts to unrelated locations, duplicated limbs, distorted hands, floating feet, sudden costume changes, exaggerated acrobatics, theatrical facial expressions, subtitles, text, or logos.",
"resolution": "2K",
"aspect_ratio": "21:9"
}
},
)
task = res.json()Input parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
prompt |
string | Yes | Video description prompt. (max 7000 chars) | Create a 15-second cinematic contemporary-danc |
duration |
integer | Yes | Video duration in seconds. Available values: 4-15. (min 4, max 15) | 15 |
resolution |
string | No | Video resolution. Opsi: 768P 2K |
2K |
aspect_ratio |
string | Yes | The ratio of output video. Opsi: 21:9 16:9 4:3 1:1 3:4 9:16 |
21:9 |
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/text-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.
