Skip to main content
POST

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:

Mode Pembuatan

MiniMax-H3 merutekan ke mode yang sesuai dari field permintaan secara otomatis. Anda tidak memerlukan field mode:
Saling eksklusif secara ketat: Field gambar-ke-video (first_frame_image / last_frame_image, dan first_frame / last_frame di image_with_roles) tidak dapat digabungkan dengan field referensi multimodal (image_urls, video_urls, audio_urls, dan reference_image di image_with_roles). Mencampurkannya akan mengembalikan 400.
Audio saja tidak diizinkan. Jika Anda mengirim audio_urls, Anda juga harus menyediakan setidaknya satu gambar referensi atau video referensi.

Parameter Permintaan

Field Umum

string
wajib
Nilai tetap: MiniMax-H3
model wajib dan harus dikirim secara eksplisit. Klien yang sudah terintegrasi dengan Hailuo dapat beralih dengan mengatur model ke MiniMax-H3.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Deskripsi konten video. Wajib dan tidak boleh kosong di setiap skenario, maks. 7000 karakter per permintaan.Jelaskan adegan, subjek, gerakan, dan gaya secara detail untuk hasil yang lebih baik.Contoh: "A boy playing basketball by the sea at dusk, waves crashing, cinematic camera work"
integer
default:"5"
Durasi output (detik)
  • Rentang: bilangan bulat dari 4 hingga 15
  • Default: 5
string
default:"2K"
Resolusi videoOpsi:
  • 2K (default)
  • 768P
string
Rasio aspek. Anda juga dapat mengirim size atau ratio dengan efek yang sama.Rasio yang diizinkan: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16Perilaku per skenario dijelaskan di “Aturan Rasio Aspek” di bawah.
boolean
default:"false"
Apakah menambahkan watermark AIGCDefault: falseAlias kompatibel: aigc_watermark
string
URL yang menerima push saat tugas mencapai status terminal (berhasil / gagal)
Gunakan webhook. Jangan mengirim callback_url resmi. callback_url dicadangkan untuk penggunaan internal dan tidak diterima dari pengguna.

Field Gambar-ke-Video

Untuk gambar-ke-video frame pertama / akhir, tentukan peran secara eksplisit. Jangan menyimpulkan dari jumlah image_urls.
string
URL gambar frame pertamaSaat disediakan, gambar ini digunakan sebagai frame awal video.
string
URL gambar frame akhirSaat disediakan, gambar ini digunakan sebagai frame penutup. Gabungkan dengan first_frame_image untuk kontrol frame pertama+akhir.

Field Referensi Multimodal

string[]
Array URL gambar referensi
Setiap gambar di image_urls diperlakukan sebagai gambar referensi (reference_image), terlepas dari jumlahnya. Gambar tidak pernah dipetakan otomatis ke frame pertama / pertama+akhir berdasarkan panjang array.
  • Jumlah: ≤ 9
string[]
Array URL video referensi
  • Jumlah: ≤ 3
  • Format dan batasan: lihat “Batasan Media Input” di bawah
string[]
Array URL audio referensi
  • Jumlah: ≤ 3
  • Tidak dapat digunakan sendiri; harus dipasangkan dengan gambar referensi atau video referensi

Array Gambar Bersama (Formulir Opsional)

object[]
Array gambar ber-tag peran. Dapat menggantikan first_frame_image / last_frame_image / image_urls. Setiap elemen:Contoh (frame pertama + akhir):
Contoh (gambar referensi):

Aturan Rasio Aspek

Rasio konkret yang diizinkan: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Batasan Media Input

Ukuran total body permintaan ≤ 64 MB. Gunakan URL publik untuk file besar; jangan gunakan Base64.

Gambar

Video (hanya referensi multimodal)

Audio (hanya referensi multimodal)

Batasan Parameter

Pelanggaran ditolak dengan 400 (konten sensitif dapat mengembalikan 422) dan tidak ditagih:

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Contoh Permintaan

Kasus 1: Teks-ke-Video

Kasus 2: Gambar-ke-Video — Frame Pertama

Kasus 3: Gambar-ke-Video — Frame Pertama + Akhir

Kasus 4: Referensi Multimodal ke Video

Kasus 5: Frame Pertama + Akhir melalui image_with_roles

Kueri Hasil TugasPembuatan video bersifat asinkron dan mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk memantau progres dan hasil.Interval poll yang disarankan: setiap 5 ~ 10 detik. Timeout klien: 15 menit. Saat berhasil, result.videos[0].url adalah URL mp4. URL video kedaluwarsa dalam sekitar 24 jam — simpan segera. Tugas yang gagal otomatis diganti uangnya.