MiniMax Hailuo 03 API: Generasi Video 1080p

Jika Anda ingin video AI 1080p melalui API, batasan utamanya sederhana: klip maks 5 detik, penanganan job async, dan biaya $0.08/dtk. Saya akan memperlakukan Hailuo 03 sebagai model video berdurasi pendek untuk aplikasi yang butuh text-to-video atau image-to-video tanpa menjalankan GPU.

Berikut artikelnya dalam bahasa sederhana:

• Apa yang dilakukannya: menghasilkan video MP4 1080p
• Tipe input: prompt teks, image-to-video, frame pertama-dan-terakhir, dan referensi subjek
• Batas klip: 5 detik pada 1080p
• Harga: $0.40 per klip 1080p 5 detik
• Alur API: kirim job, lalu poll task_id atau gunakan callback_url
• Kontrol prompt: gerakan kamera dalam tanda kurung seperti [Pan left] atau [Zoom in]
• Penanganan file: URL video final kedaluwarsa setelah 24 jam
• Aturan gambar: di bawah 20 MB dan rasio aspek antara 2:5 dan 5:2
• Catatan keandalan: artikel mengutip SLA uptime 99,9%

Yang paling penting adalah ini: Anda butuh logika backend, bukan sekadar prompt. Itu berarti menangani pemeriksaan status async, menyimpan MP4 segera, mengulang pada 429 dan 5xx, serta menyambung klip jika Anda butuh durasi lebih dari 5 detik.

Jika saya menyiapkannya, saya akan menguji prompt pada resolusi lebih rendah dulu, mengunci diksi gerakan, lalu beralih ke 1080p hanya untuk run final agar pengeluaran tetap terkendali.

Tonton: Mengotomatiskan Generasi Video MiniMax

Kemampuan Inti dan Opsi Output 1080p

Sebelum mengirim permintaan pertama, pahami dulu mode input Hailuo 03, kontrol gerakan, dan batas output.

Input yang Didukung: Prompt Teks, Gambar, dan Instruksi Gerakan

Hailuo 03 mendukung empat mode input: text-to-video, image-to-video (I2V), video frame pertama-dan-terakhir, dan video referensi subjek ^[2].

Untuk kontrol gerakan, Anda dapat menggabungkan hingga tiga gerakan kamera dalam satu instruksi bertanda kurung, seperti [Pan left, Pedestal up] ^[3]. Itu memberi Anda cara sederhana untuk memandu pembingkaian dan gerakan adegan tanpa menambahkan metadata ekstra.

Mode-mode ini selaras dengan field permintaan yang dibahas di bagian berikutnya.

Spesifikasi Output 1080p yang Harus Diverifikasi Developer

Output 1080p dibatasi pada klip 5 detik. Jika Anda butuh rangkaian lebih panjang, hasilkan beberapa klip dan sambung di backend Anda. Untuk proyek yang membutuhkan audio terintegrasi, pertimbangkan Veo 3.1 dari Google sebagai alternatif.

Batas itu harus membentuk baik pengaturan permintaan Anda maupun logika perakitan backend Anda.

Spesifikasi Hailuo 03

Cara Memanggil API MiniMax Hailuo 03 di APIMart

Setelah Anda melihat apa yang bisa dibuat Hailuo 03, saatnya menghubungkannya ke aplikasi Anda.

Autentikasi, Base URL, dan Header

Setiap permintaan ke APIMart menggunakan token Bearer di header Authorization, bersama Content-Type: application/json. Satu kunci API APIMart menangani setiap permintaan.

POST https://api.apimart.ai/v1/videos/generations

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Contoh Permintaan untuk Text-to-Video dan Image-to-Video

Anda akan menggunakan endpoint yang sama dan setup auth yang sama setiap kali. Yang berubah adalah prompt, resolusi, durasi, dan URL input.

Field model menunjuk ke Hailuo 03. resolution mengontrol kualitas output. Dan jika Anda ingin 1080p, duration harus 5.

Permintaan text-to-video:

{
  "model": "MiniMax-Hailuo-03",
  "prompt": "A product designer sketching at a sunlit desk, [Pan left, Zoom in], cinematic depth of field",
  "resolution": "1080p",
  "duration": 5,
  "prompt_optimizer": true
}

Permintaan image-to-video:

{
  "model": "MiniMax-Hailuo-03",
  "prompt": "The product rotates slowly on a white surface, [Orbit right]",
  "resolution": "1080p",
  "duration": 5,
  "first_frame_image": "https://your-storage.com/product-shot.jpg",
  "prompt_optimizer": true
}

Untuk image-to-video, unggah gambar terlebih dahulu dan gunakan URL yang dikembalikan di first_frame_image. Gambar harus di bawah 20 MB, dan rasio aspeknya perlu tetap antara 2:5 dan 5:2. Jika di luar rentang itu, API mengembalikan error 400. Atur prompt_optimizer ke true jika Anda ingin prompt disempurnakan sebelum generasi.

Respons Async, Status Job, dan URL Video Final

Generasi video berjalan secara asinkron, jadi aplikasi Anda perlu melakukan polling status atau menggunakan callback.

"Setelah mengirimkan tugas, poll statusnya menggunakan task_id hingga berhasil atau gagal." - MiniMax API Docs ^[2]

Poll endpoint ini setiap 15–30 detik:

GET https://api.apimart.ai/v1/tasks/{task_id}

Field status melewati beberapa tahap:

Ketika status mencapai completed, respons menyertakan URL MP4 final. Unduh MP4 segera karena tautan kedaluwarsa setelah 24 jam ^[4].

Jika Anda menangani banyak job, kirim callback_url pada permintaan pertama alih-alih polling. Server Anda akan menerima callback POST saat job selesai, dan harus mengembalikan nilai challenge dalam 3 detik ^[3].

Dengan alur job siap, langkah berikutnya adalah menyetel kualitas dan biaya untuk produksi. Anda juga dapat mempertimbangkan Kling V3 untuk gaya video sinematik alternatif.

Parameter, Performa, dan Harga untuk Beban Kerja 1080P

Kontrol Kualitas yang Penting dalam Produksi

Setelah format permintaan Anda disetel, langkah berikutnya adalah menyetel kualitas output, kecepatan, dan pengeluaran. Untuk sebagian besar job 1080P, tiga pengaturan melakukan sebagian besar pekerjaan: resolution, duration, dan prompt_optimizer.

prompt_optimizer menulis ulang prompt agar gerakan dan komposisi lebih jelas ^[1][3]. Dalam sebagian besar kasus produksi, sebaiknya biarkan menyala. Tetapi jika prompt Anda perlu mengikuti istilah merek atau diksi persis, atur ke false agar sistem tidak menulis ulang bahasa yang perlu Anda pertahankan ^[3].

Anda juga dapat menggunakan fast_pretreatment untuk memangkas waktu persiapan prompt. Trade-off-nya adalah sedikit penurunan kualitas output ^[1][3].

Untuk gerakan kamera, letakkan arahan gerakan langsung di prompt dengan perintah bertanda kurung. Contohnya termasuk [Pan left] dan [Zoom in]. Anda dapat menggunakan hingga tiga perintah ini dalam satu prompt ^[3][5].

Perencanaan Latensi dan Biaya dalam USD

Setelah kontrol itu diterapkan, biaya sebagian besar bergantung pada durasi klip. Karena generasi berjalan asinkron, rencanakan alur submit-and-poll. Jika Anda ingin backend mendapatkan hasil secara otomatis, gunakan callback_url agar menerima pemberitahuan saat job selesai ^[4].

Pada $0.08 per detik, sebuah klip 1080P 5 detik berharga $0.40.

Satu cara sederhana memangkas pemborosan adalah menguji prompt pada 768P dulu, lalu beralih ke 1080P setelah perilaku prompt dan gerakan kamera terlihat tepat ^[1][6].

Pola Integrasi dan Langkah Berikutnya

Alur Kerja Backend untuk Aplikasi Pemasaran, Produk, dan Edukasi

Dengan penanganan permintaan dan status job disiapkan, langkah berikutnya adalah memasukkan Hailuo 03 ke alur produk nyata. Alur job inti tetap sama di seluruh tipe aplikasi. Yang berubah adalah gaya prompt, input yang Anda kirim, dan apa yang harus dilakukan klip.

Untuk klip iklan pemasaran, gunakan text-to-video. Buat prompt singkat dan langsung, dan sertakan isyarat kamera seperti [Pan left] atau [Tracking shot]. Untuk visual produk, gunakan image-to-video dan kirim bidikan produk sebagai gambar referensi. Untuk penjelas edukasi, 768P sering jadi pilihan praktis ketika Anda butuh klip lebih panjang.

Penyimpanan, Pengiriman, dan Pelacakan Penggunaan di Skala Besar

Setelah render selesai, pindahkan file ke penyimpanan persisten untuk pengiriman dan pelacakan. Unduh setiap MP4 segera dan simpan di sistem Anda sendiri untuk pengiriman. Untuk keandalan, tambahkan exponential backoff pada respons 429 dan 5xx. Jika Anda menangani volume tinggi, gunakan callback_url alih-alih polling. Lacak penggunaan di satu tempat di seluruh job video. Setup itu membantu menjaga pengiriman tetap stabil seiring pertumbuhan volume.

Kesimpulan: Poin Utama untuk Developer

Kirim job dengan tipe input yang tepat untuk kasus penggunaan, tangani alur async dengan cermat, dan simpan output segera - lalu bangun dari sana.

FAQ

Berapa lama video 1080p biasanya butuh untuk dihasilkan?

Generasi video 1080p berkualitas tinggi biasanya butuh 1 menit 38 detik hingga 5 menit, meskipun beberapa job selesai dalam 30 hingga 90 detik.

Waktu pastinya bergantung pada dua hal: seberapa kompleks prompt Anda dan seberapa panjang video yang Anda inginkan. Karena generasi berjalan asinkron, aplikasi Anda harus melakukan polling status tugas hingga selesai.

Apa cara terbaik membuat video lebih panjang dari 5 detik?

Untuk membuat video lebih panjang dari 5 detik dengan API MiniMax Hailuo, gunakan resolusi lebih rendah.

1080p hanya mendukung klip 5 atau 6 detik, tergantung versi model. 768p mendukung klip hingga 10 detik.

Jadi jika Anda ingin video 10 detik, atur:

• resolution ke 768p
• duration ke 10

Dalam permintaan API Anda, idenya dalam praktik seperti ini: gunakan 768p untuk resolusi dan 10 untuk durasi.

Kapan saya harus mematikan prompt_optimizer?

Matikan prompt_optimizer ketika Anda ingin kontrol lebih ketat atas output video. Secara default, sistem menulis ulang deskripsi Anda untuk membantu meningkatkan hasil.

Matikan jika Anda ingin prompt Anda digunakan persis seperti tertulis, terutama jika Anda sudah menyetelnya dengan halus dan tidak ingin ada yang diubah.