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.
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 video
  • Nilai yang didukung: hanya 2K (default)
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.