GetRun by Getcore API Documentation

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.

POSThttps://getrun.id/v1/tasks
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

NameTypeRequiredDescriptionExample
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.

GEThttps://getrun.id/v1/tasks/{task_id}

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

StatusKeterangan
queuedTugas sedang diantrikan.
processingSedang diproses.
succeededBerhasil.
failedGagal — lihat error detail, tidak ditagih.
Output bertipe 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.

On this page
1 · Create a task Input parameters 2 · Poll the result Status values Best practices
Pricing summary
MiniMax H3 Text to Video
Mulai Rp5.176 / video
  • Harga jelas, pembayaran mudah.
  • Transparan, tanpa biaya tersembunyi.
  • Task gagal tidak ditagih.
Try in Playground ↗

Eksperimen model ini langsung di Playground untuk hasil instan.

Model details
Model IDminimax-h3/text-to-video
Modalityvideo
Output typevideo/mp4
API versionv1
Need help?

Lihat daftar error umum di Error handling atau hubungi support@getcore.id.