Cara Menggunakan MiniMax Hailuo 02: Panduan Lengkap

MiniMax Hailuo 02 adalah model AI yang kuat untuk membuat video berkualitas sinematik dengan kontrol presisi atas visual, gerakan, dan efek. Tersedia di APIMart, model ini mendukung text-to-video, image-to-video, dan transisi berbasis frame, sehingga Anda bisa menghasilkan klip pendek berkualitas tinggi dengan resolusi hingga 1080p. Berikut hal-hal yang perlu Anda ketahui:

• Fitur Utama: Membuat video dari prompt teks, gambar, atau transisi frame dengan opsi gerakan kamera seperti [Pan left] atau [Zoom in].
• Harga: Klip 1080p seharga $0.08/detik dengan diskon 20% di APIMart.
• Persiapan: Buat API key, susun request Anda dengan parameter, dan gunakan polling asinkron untuk mengambil video.
• Aplikasi: Ideal untuk iklan, showcase produk, storyboarding, dan video pelatihan.

Untuk memulai, buat akun APIMart, amankan API key Anda, lalu ikuti panduan langkah demi langkah untuk menghasilkan video. Gunakan prompt yang spesifik dan perintah kamera untuk memaksimalkan kualitas video. Untuk proyek yang lebih panjang, gabungkan beberapa klip menggunakan frame yang konsisten atau jelajahi Kling V3 untuk alternatif pembuatan video sinematik.

Memulai dengan MiniMax Hailuo 02 di APIMart

Pengaturan Akun dan Akses API Key

Untuk memulai, kunjungi apimart.ai dan buat sebuah akun. Jika Anda bagian dari tim, APIMart memungkinkan Anda menyiapkan sebuah organisasi. Fitur ini mempermudah kolaborasi dengan membiarkan semua orang berbagi saldo terpusat, sehingga tidak perlu lagi bertukar kredensial pribadi.

Setelah akun Anda siap, isi saldo bersama Anda. Saldo ini berlaku di seluruh 500+ model yang tersedia di platform. Ini termasuk opsi kelas atas lainnya seperti Veo 3.1 untuk pembuatan video tingkat profesional. Selanjutnya, buka bagian API Key Management di Console Dashboard dan buat sebuah API key.

Perlu diingat: API key Anda hanya ditampilkan satu kali. Pastikan untuk menyalinnya dan menyimpannya dengan aman, misalnya di pengelola kata sandi atau brankas rahasia. Saat menggunakan key di kode Anda, muat dari sebuah variabel lingkungan (misalnya, MINIMAX_API_KEY) daripada menyematkannya secara langsung. Ini mengurangi risiko paparan yang tidak disengaja jika kode Anda dibagikan atau diunggah ke version control. Setiap request API yang Anda buat akan menyertakan key ini di header otorisasi:

Authorization: Bearer YOUR_API_KEY

Untuk tim, fitur Organizations adalah cara yang bagus untuk mengelola akses secara terpusat, menghindari kebutuhan berbagi kredensial akun individu ^[2]. Dengan API key Anda siap, Anda dapat mengonfigurasi parameter request dan mulai menghasilkan video. Anda juga bisa menjelajahi Grok Imagine Video untuk output berkualitas tinggi alternatif.

Parameter Kunci untuk Request MiniMax Hailuo 02

Setelah API key Anda diamankan, Anda perlu menyiapkan request dengan parameter yang tepat. Field "model": "MiniMax-Hailuo-02" wajib ada, bersama beberapa lainnya. Berikut ikhtisar singkat parameter terpenting:

Satu detail penting: pembuatan video bersifat asinkron. Saat Anda mengirim request, API merespons dengan sebuah task_id alih-alih video itu sendiri. Anda perlu melakukan polling ke /v1/tasks/{task_id} setiap 15–30 detik hingga statusnya berubah menjadi "completed". Begitu siap, unduh video segera, karena tautan yang dihasilkan kedaluwarsa setelah 24 jam ^[2].

Dengan parameter Anda siap, Anda siap berfokus menyusun prompt yang efektif untuk memanfaatkan MiniMax Hailuo 02 sepenuhnya.

Cara Menulis Prompt yang Efektif

Membuat prompt yang baik adalah kunci untuk menghasilkan video berkualitas tinggi. Prompt yang tersusun baik mencakup enam elemen: pengambilan atau gerakan kamera, subjek dan deskripsi, aksi, adegan, pencahayaan, dan gaya atau suasana. Misalnya, alih-alih deskripsi samar seperti "seorang wanita berjalan di kota," coba sesuatu yang lebih spesifik: "[Tracking shot] Seorang wanita bermantel merah berjalan cepat di jalanan Manhattan yang basah oleh hujan saat senja, papan neon memantul di trotoar yang basah, gaya noir sinematik."

Untuk membuat video Anda dinamis, sertakan perintah kamera langsung dalam prompt Anda. Perintah seperti [Pan left, Pedestal up] dapat menambahkan gerakan, sementara yang lain seperti [Truck left], [Push in], atau [Static shot] memberikan kontrol lebih atas perspektif ^[3].

Saat menangani adegan kompleks, biarkan prompt_optimizer disetel ke true. Fitur ini secara otomatis menyempurnakan dan memperluas deskripsi Anda, sering kali menghasilkan output video yang lebih halus dan koheren dengan usaha minimal ^[1].

Cara Membuat Video AI Sinematik di Hailuo 02

Panduan Langkah demi Langkah: Menghasilkan Video dengan MiniMax Hailuo 02

Cara Membuat Request API Text-to-Video Dasar

Jika API key dan prompt Anda sudah siap, mengirim request pertama Anda mudah. Cukup lakukan panggilan POST ke https://api.apimart.ai/v1/videos/generations. Sertakan Bearer Token Anda di header dan gunakan body JSON seperti ini:

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "[Tracking shot] A lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
  "duration": 5,
  "resolution": "1080p"
}

Penting: Resolusi 1080p hanya mendukung klip 5 detik. Untuk video 10 detik, Anda perlu menurunkan resolusi ke 768p atau 512p. Harga bergantung pada resolusi dan durasi - 768p seharga $0.04 per detik, sementara 1080p dihargai $0.08 per detik ^[2].

Saat Anda mengirim request, API akan mengembalikan sebuah task_id dan status submitted. Video akan butuh waktu antara 30 hingga 90 detik untuk dirender ^[2].

Cara Menggunakan Fitur Image-to-Video

Untuk request image-to-video, Anda perlu menyertakan parameter tambahan: first_frame_image. Ini bisa berupa URL publik (misalnya, https://example.com/start.jpg) atau string Data URL berenkode Base64. Pastikan gambar memenuhi persyaratan tipe file, ukuran, dan rasio aspek yang ditentukan.

Prompt Anda sebaiknya mendeskripsikan gerakan, bukan detail visual adegan, karena gambar sudah memberikan konteks itu. Misalnya, jika gambar awal Anda adalah sebuah produk di atas meja, prompt seperti "[Slow zoom in] Product rotates gently, soft studio lighting, clean white background" memberi tahu model cara menganimasikannya. Resolusi output akan menyesuaikan dimensi gambar input Anda, jadi menggunakan sumber berkualitas tinggi penting untuk hasil yang tajam.

Untuk efek yang lebih canggih, Anda bisa menyertakan last_frame_image bersama first_frame_image. Ini membuat video transisi antara dua gambar, yang sempurna untuk hal-hal seperti reveal produk, perbandingan sebelum-dan-sesudah, atau transisi adegan dalam proyek yang lebih besar.

Setelah request Anda disiapkan, pantau respons API untuk mengambil video animasi Anda. Untuk proyek yang membutuhkan audio terintegrasi, pertimbangkan menjelajahi Veo 3.1 API yang mendukung pembuatan suara tersinkronisasi.

Membaca Respons API dan Mengunduh Output

Saat status tugas Anda berubah menjadi success, API akan memberikan sebuah file_id. Gunakan ini dalam request "Retrieve File" terpisah untuk mendapatkan download_url. Berikut cara kerja alur status:

Lakukan polling ke endpoint /v1/tasks/{task_id} setiap 15–30 detik hingga status berubah menjadi success. Begitu berubah, minta video dan unduh. Ingat bahwa tautan unduhan kedaluwarsa setelah 24 jam, jadi pastikan menyimpan file Anda segera ^[2].

Jika Anda bekerja dengan Python, Anda dapat menggunakan requests.get(download_url).content untuk mengunduh video dan menyimpannya sebagai file .mp4. Untuk menghindari polling manual, Anda dapat menyiapkan sebuah callback_url dalam request Anda. Dengan cara ini, APIMart akan memberi tahu server Anda dengan request POST saat status tugas diperbarui menjadi success atau failed ^[3].

Terakhir, selalu periksa field code dalam respons API. Nilai 200 berarti request berhasil, tetapi Anda tetap perlu memantau status tugas untuk potensi kesalahan rendering ^[1][3].

Meningkatkan Kualitas Video dan Integrasi Alur Kerja

Menyempurnakan Prompt dan Pengaturan Parameter

Untuk meningkatkan kualitas video, coba susun prompt dengan format ini: [Subjek & aksi], [elemen fisik/lingkungan], [gerakan kamera], [pencahayaan/atmosfer], [deskriptor kualitas] ^[7]. Berikut contohnya: "Seorang barista menuangkan susu mengepul ke espresso, cairan berputar dalam gerak lambat, [Zoom in], pencahayaan kafe yang hangat, kualitas sinematik." Pendekatan ini membantu model mensimulasikan gerakan dan atmosfer realistis secara lebih efektif.

MiniMax-Hailuo-2.3 menawarkan 15 perintah kamera, yang bisa Anda kombinasikan (hingga tiga) dalam satu set tanda kurung, seperti [Pan left, Pedestal up] ^[3]. Gunakan tabel di bawah untuk referensi cepat:

Secara default, fitur prompt_optimizer aktif, yang umumnya meningkatkan kualitas output. Biarkan menyala kecuali Anda perlu model mengikuti skrip yang sangat spesifik. Jika kecepatan adalah prioritas Anda dan Anda tidak masalah dengan hasil yang kurang halus, setel fast_pretreatment: true untuk mengurangi waktu prapemrosesan ^[1][6].

Setelah prompt dan pengaturan Anda diperhalus, integrasikan ke dalam pipeline yang lebih luas untuk meningkatkan kualitas produksi Anda.

Membangun Pipeline Multi-Model dengan APIMart

Hailuo 02 bekerja paling baik saat dipasangkan dengan alat pelengkap untuk audio dan urutan yang diperpanjang. Meskipun unggul dalam membuat footage B-roll yang dinamis secara visual - seperti air, api, atau kain - ia tidak menghasilkan audio. Untuk mengisi celah ini, pasangkan dengan alat MiniMax Audio, seperti Speech 2.8 untuk sulih suara atau Music 2.6 untuk soundtrack, selama pasca-produksi ^[8]. Untuk proyek merek atau komersial, mulai dengan model gambar untuk menghasilkan frame dasar, lalu masukkan ke Hailuo 02 sebagai first_frame_image untuk kontrol presisi atas komposisi ^[7].

Untuk video lebih panjang dari 10 detik, ambil tangkapan layar dari frame terakhir klip yang sudah selesai dan gunakan sebagai first_frame_image untuk request berikutnya. Teknik ini memastikan konsistensi dalam detail karakter dan pencahayaan lingkungan di beberapa klip ^[8].

"Konsistensi MiniMax Hailuo 02 luar biasa! Gambar karakter tetap stabil di beberapa klip." - Wei Zhang, Animator Independen ^[2]

Penanganan Kesalahan dan Praktik Terbaik API

Bahkan dengan prompt dan pipeline yang diperhalus, masalah bisa muncul. Ikuti praktik terbaik ini untuk memecahkan masalah dan mengoptimalkan respons API secara efektif.

Dua kegagalan paling umum dengan Hailuo 02 melibatkan kombinasi resolusi/durasi yang tidak didukung dan input gambar yang tidak valid. Selalu periksa bahwa pengaturan resolusi dan durasi Anda kompatibel ^[1][6]. Untuk tugas image-to-video, pastikan gambar sumber Anda di bawah 20MB, memiliki sisi pendek lebih besar dari 300px, dan rasio aspek antara 2:5 dan 5:2. Format yang dapat diterima meliputi JPG, PNG, dan WebP ^[5].

Saat sebuah tugas gagal, selalu periksa field error_message dalam respons JSON. Ia memberikan diagnostik terperinci untuk membantu menyelesaikan masalah dengan cepat ^[4]. Untuk penyiapan produksi, gunakan parameter callback_url alih-alih polling manual. Ini mengurangi panggilan API yang tidak perlu dan menjaga alur kerja Anda tetap responsif ^[3].

Kesimpulan: Poin-Poin Penting

Berikut rangkuman singkat tentang apa yang membuat MiniMax Hailuo 02 menjadi alat unggulan untuk pembuatan video.

MiniMax Hailuo 02 menawarkan pembuatan video berkualitas sinematik dengan presisi luar biasa. Berkat arsitektur NCR-nya, yang memiliki 3x parameter dan 4x data pelatihan dibandingkan model sebelumnya ^[7], ia menghasilkan efek yang sangat realistis untuk elemen kompleks seperti air, api, asap, dan kain.

Melalui APIMart, Anda dapat memperoleh diskon 20%, bersama harga kompetitif untuk resolusi 768p dan 1080p ^[2]. Ia menawarkan SLA uptime 99,9% dan waktu pembuatan tipikal hanya 30 hingga 90 detik ^[2], menjadikannya pilihan praktis untuk segala hal mulai dari produksi profesional hingga eksperimen kreatif. Bagi mereka yang membutuhkan ruang kerja yang lebih visual, sebuah editor kanvas AI dapat lebih menyederhanakan proses pengeditan.

Fitur unggulan model ini meliputi:

• Alat Image-to-Video untuk kontrol presisi.
• Perintah kamera dalam tanda kurung (misalnya, [Tracking shot], [Zoom in]) untuk sinematografi tingkat profesional.
• Kontinuitas frame terakhir, memastikan transisi mulus untuk urutan yang diperpanjang.

Pengguna telah memuji keandalan dan kecepatannya. Seperti yang dibagikan David Chen, seorang Full-Stack Engineer:

"Saya menghargai stabilitas dan kecepatan. MiniMax Hailuo 02 memberikan performa yang luar biasa." ^[2]

Ingat, klip 1080p dibatasi hingga 5–6 detik. Untuk video yang lebih panjang, 768p adalah alternatif yang bagus, menawarkan kualitas konsisten dengan harga kompetitif ^[1][3].

Dengan fitur-fitur ini, MiniMax Hailuo 02 siap meningkatkan alur kerja produksi video Anda ke tingkat berikutnya.

FAQ

Bagaimana cara membuat klip lebih panjang dari 10 detik?

MiniMax Hailuo 02 memiliki batas durasi klip maksimum 10 detik. Jika Anda membutuhkan klip yang lebih panjang, Anda harus bekerja dalam batasan ini. Setel durasi ke 10 detik dan pilih resolusi yang kompatibel, seperti 768p atau 1080p, dalam request Anda.

Untuk tugas text-to-video, sertakan parameter berikut dalam request Anda:

• duration: 10
• resolution: "768P"
• model: "MiniMax-Hailuo-02"

Setelah mengirim request, periksa status tugas dan unduh file yang dihasilkan setelah siap.

Apa yang harus saya lakukan jika tugas saya gagal?

Jika tugas pembuatan video Anda tidak berjalan, mulai dengan meninjau pesan status API untuk menentukan masalahnya. Berikut beberapa kode kesalahan umum yang perlu diperhatikan:

• 1002: Menunjukkan Anda telah mencapai batas rate.
• 1004/2049: Menunjuk ke masalah otentikasi.
• 1008: Menandakan saldo yang tidak mencukupi di akun Anda.
• 1026: Menandai konten sensitif dalam input.

Untuk kesalahan rate limit (HTTP 429) atau masalah terkait server (HTTP 5xx), coba terapkan exponential backoff - ini berarti menambahkan penundaan yang semakin lama di antara percobaan ulang. Selain itu, periksa kembali parameter input Anda dan pastikan prompt Anda menghindari konten sensitif untuk menghindari kesalahan validasi.

Bagaimana cara menjaga karakter tetap konsisten di seluruh klip?

Untuk menjaga konsistensi karakter di MiniMax Hailuo 02, pilih mode Subject Reference dan gunakan gambar referensi yang jelas dan terang. Jika Anda bekerja dengan beberapa klip, pastikan konsistensi dengan menyertakan detail pencahayaan yang serasi dalam prompt Anda. Untuk alur visual yang lebih mulus, selaraskan sudut kamera di seluruh pengambilan dan pertimbangkan transisi halus seperti crossfade atau match-cut selama pasca-produksi. Teknik-teknik ini membantu menciptakan narasi yang kohesif dan rapi.