{ "aboutHtml": "

Satu hasil audiovisual dari arahan multimodal

MiniMax H3 adalah sistem video omni-modal MiniMax. Sistem ini menafsirkan teks, gambar, video, dan audio bersama, lalu menghasilkan video dengan bunyi stereo bawaan. Pembuatnya menyajikannya untuk karya kreatif singkat seperti visual produk, periklanan, poster animasi, dan konsep judul film, ketika hubungan antar aset referensi sama pentingnya dengan deskripsi adegan.

Sistem yang didokumentasikan menghasilkan video 4–15 detik pada 24 bingkai per detik dengan audio stereo 32 kHz. Generasi H3-Base beroperasi pada 768p; alur kerja 2K penuh meregenerasi hasil itu menggunakan konteks multimodal asli. Ini lebih dari pengubahan ukuran konvensional: tahap kedua menggunakan model dan konteks sumber lagi untuk memulihkan detail halus. H3 Max dan H3-Context-IR memiliki peran serta batas terpisah.

Kreasi teks dan berpanduan bingkai

Masukan hanya teks menjelaskan seluruh linimasa audiovisual. Gambar pertama menambatkan pembukaan, gambar terakhir menambatkan penutup, dan dua gambar dapat menentukan keduanya. Untuk shot bingkai pertama, mulailah dengan komposisi serta identitas yang terlihat dalam gambar diam, lalu jelaskan tindakan yang berkembang darinya. Untuk transisi bingkai pertama ke terakhir, jelaskan gerakan yang dapat diamati yang menghubungkan kedua keadaan, alih-alih mengulangi dua deskripsi gambar yang tidak berkaitan.

Arahan produk praktis dapat menentukan kemasan tertutup dalam bingkai pembuka, tangan yang membukanya, gerak kamera lembut, dan keadaan akhir yang harus dicapai. Pertahankan bentuk objek, penempatan label, serta pencahayaan dalam bingkai yang diberikan. Kreasi berpanduan bingkai dan kreasi berpanduan referensi merupakan mode masukan terpisah; antarmuka pembuatnya tidak mencampurkan peran bingkai pertama/terakhir dengan peran media referensi dalam satu permintaan.

Generasi dan penyuntingan berpanduan referensi

Mode referensi menerima teks dengan gambar, klip video, dan klip audio. Identifikasi kontribusi setiap sumber: penampilan karakter, lokasi, gerak kamera, struktur waktu klip sumber, atau suara. Video yang hanya digunakan untuk gerak kamera berbeda dari video yang benar-benar perlu disunting atau dilanjutkan. Nyatakan hubungan itu secara eksplisit.

Panduan referensi pembuatnya memisahkan definisi subjek, ringkasan tugas, analisis pemertahanan, deskripsi shot terperinci, lanskap bunyi keseluruhan, dan musik latar yang hanya didengar audiens. Panduan membedakan pemertahanan konten visual dari transfer atribut atau referensi gaya yang luas. Untuk audio, menyalin sinyal berbeda dari merujuk timbre, irama, atau penyampaian. Pertahankan kestabilan peran tersebut di seluruh arahan.

Untuk adegan berbasis referensi, berikan gambar karakter, referensi gerak kamera singkat, dan referensi suara audio, lalu jelaskan bagian shot sasaran yang dipengaruhi masing-masing. Nyatakan detail pakaian, lingkungan, atau objek yang harus tetap dapat dikenali. Bandingkan klip akhir dengan persyaratan tersebut, termasuk kesinambungan gerak dan hubungan antara penutur yang terlihat dengan suara yang terdengar.

Ucapan, bunyi, dan pengaturan waktu shot

H3 memodelkan dialog, bunyi fisik, suasana, dan musik bersama. Kartu model mendokumentasikan dukungan dialog stabil untuk bahasa Arab, Tionghoa, Inggris, Prancis, Jerman, Italia, Jepang, Korea, Portugis, Rusia, dan Spanyol; bahasa lain digambarkan memiliki dukungan yang bervariasi. Berikan kata-kata lisan serta bahasa yang persis, dengan identitas penutur yang stabil antarshot.

Panduan penulisan prompt pembuatnya menggunakan bahasa Inggris untuk bagian deskriptif sambil mempertahankan dialog serta teks visual dalam bahasa aslinya. Konten lisan menggunakan <d>[Language] ...</d>, dengan identitas penutur dan deskripsi suara di luar blok. Bedakan ucapan fisik dari sulih suara di luar layar, dan identifikasi kapan kalimat berlanjut melewati potongan shot atau terputus oleh akhir. Pertahankan teks visual secara persis juga. Sesuaikan jumlah ucapan dengan durasi pilihan dan periksa kata-kata yang dirender serta kalimat yang terdengar bersama.

Jelaskan gerak kamera sebagai tindakan, termasuk rentang dan kecepatannya ketika penting. Beri nomor shot menurut urutan pemutaran dan jaga waktu potongan berada dalam durasi video. Pisahkan bunyi adegan seperti langkah kaki atau pintu menutup dari musik latar yang hanya terdengar bagi audiens. Pilihan ini membuat rencana shot singkat lebih mudah ditafsirkan serta ditinjau terhadap hasilnya.

Persiapan masukan dan batas numerik

Skema generasi saat ini mewajibkan teks yang tidak kosong dalam setiap mode, hingga 7.000 karakter per item teks. Gambar dapat berupa JPG, JPEG, PNG, WebP, HEIC, atau HEIF, masing-masing hingga 30 MB, dengan setiap sisi dari 256 hingga 5.760 piksel dan rasio aspek dari 0,4 hingga 2,5. Masukan bingkai mengizinkan satu gambar pembuka dan satu penutup; mode referensi mengizinkan hingga sembilan gambar referensi.

Video referensi dapat memuat hingga tiga klip MP4 atau MOV, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Klip boleh hingga 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi dari 256 hingga 5.760 piksel, rasio dari 0,4 hingga 2,5, dan laju bingkai dari 23,976 hingga 60. Audio referensi mendukung hingga tiga klip WAV atau MP3, masing-masing hingga 15 MB, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Kartu model membatasi masukan referensi campuran hingga 12 berkas. Batas badan permintaan yang didokumentasikan adalah 64 MB, terpisah dari batas per berkas.

Pilih hanya referensi yang berkontribusi pada arahan dan perjelas setiap kontribusi. Tampilan subjek yang jelas lebih berguna daripada beberapa tampilan yang bertentangan tanpa penjelasan. Pertahankan urutan referensi, pangkas materi tidak relevan tanpa menghilangkan konteks adegan yang diperlukan, dan periksa bahwa klip sumber singkat memuat tindakan atau karakteristik suara yang diminta.

Bentuk keluaran dan sistem lengkap

Antarmuka H3 produsen menawarkan 768P dan 2K. Generasi hanya teks memerlukan rasio konkret: 21:9, 16:9, 4:3, 1:1, 3:4, atau 9:16. Kreasi bingkai pertama/terakhir mengambil rasio aspek dari gambar masukan; kreasi referensi dapat menggunakan rasio adaptif atau eksplisit. Durasi keluaran dalam bilangan bulat adalah 4–15 detik.

Kartu model membedakan H3-Context-IR, yang menafsirkan dan memperkaya arahan, H3-Base, yang menghasilkan konten audiovisual, serta H3-Regenerate-2K, yang menciptakan hasil beresolusi lebih tinggi. Checkpoint dasar yang dirilis memisahkan tugas berpanduan bingkai dan omni-reference. Komponen konteks serta regenerasi berbeda dari bobot dasar itu, sehingga nama checkpoint terbuka saja tidak membuktikan perilaku seluruh sistem.

Alur kerja generasi pembuatnya bersifat asinkron. Antarmuka kueri tugasnya mengambil tugas dari tujuh hari sebelumnya. Simpan identitas tugas hingga hasil video sebenarnya dikembalikan, lalu simpan klip, alih-alih hanya mempertahankan alamat unduhan berbatas waktu. Tinjau identitas visual, teks kecil, interaksi objek, konten lisan, dan waktu bunyi pada ukuran tontonan yang dimaksud. Produsen mengidentifikasi pemahaman multimodal serta detail visual halus sebagai area yang terus ditingkatkan; arahan terperinci dan perbandingan sumber tetap menjadi inti hasil yang berguna.

", "aboutText": "Satu hasil audiovisual dari arahan multimodal\n\nMiniMax H3 adalah sistem video omni-modal MiniMax. Sistem ini menafsirkan teks, gambar, video, dan audio bersama, lalu menghasilkan video dengan bunyi stereo bawaan. Pembuatnya menyajikannya untuk karya kreatif singkat seperti visual produk, periklanan, poster animasi, dan konsep judul film, ketika hubungan antar aset referensi sama pentingnya dengan deskripsi adegan.\n\nSistem yang didokumentasikan menghasilkan video 4–15 detik pada 24 bingkai per detik dengan audio stereo 32 kHz. Generasi H3-Base beroperasi pada 768p; alur kerja 2K penuh meregenerasi hasil itu menggunakan konteks multimodal asli. Ini lebih dari pengubahan ukuran konvensional: tahap kedua menggunakan model dan konteks sumber lagi untuk memulihkan detail halus. H3 Max dan H3-Context-IR memiliki peran serta batas terpisah.\n\nKreasi teks dan berpanduan bingkai\n\nMasukan hanya teks menjelaskan seluruh linimasa audiovisual. Gambar pertama menambatkan pembukaan, gambar terakhir menambatkan penutup, dan dua gambar dapat menentukan keduanya. Untuk shot bingkai pertama, mulailah dengan komposisi serta identitas yang terlihat dalam gambar diam, lalu jelaskan tindakan yang berkembang darinya. Untuk transisi bingkai pertama ke terakhir, jelaskan gerakan yang dapat diamati yang menghubungkan kedua keadaan, alih-alih mengulangi dua deskripsi gambar yang tidak berkaitan.\n\nArahan produk praktis dapat menentukan kemasan tertutup dalam bingkai pembuka, tangan yang membukanya, gerak kamera lembut, dan keadaan akhir yang harus dicapai. Pertahankan bentuk objek, penempatan label, serta pencahayaan dalam bingkai yang diberikan. Kreasi berpanduan bingkai dan kreasi berpanduan referensi merupakan mode masukan terpisah; antarmuka pembuatnya tidak mencampurkan peran bingkai pertama/terakhir dengan peran media referensi dalam satu permintaan.\n\nGenerasi dan penyuntingan berpanduan referensi\n\nMode referensi menerima teks dengan gambar, klip video, dan klip audio. Identifikasi kontribusi setiap sumber: penampilan karakter, lokasi, gerak kamera, struktur waktu klip sumber, atau suara. Video yang hanya digunakan untuk gerak kamera berbeda dari video yang benar-benar perlu disunting atau dilanjutkan. Nyatakan hubungan itu secara eksplisit.\n\nPanduan referensi pembuatnya memisahkan definisi subjek, ringkasan tugas, analisis pemertahanan, deskripsi shot terperinci, lanskap bunyi keseluruhan, dan musik latar yang hanya didengar audiens. Panduan membedakan pemertahanan konten visual dari transfer atribut atau referensi gaya yang luas. Untuk audio, menyalin sinyal berbeda dari merujuk timbre, irama, atau penyampaian. Pertahankan kestabilan peran tersebut di seluruh arahan.\n\nUntuk adegan berbasis referensi, berikan gambar karakter, referensi gerak kamera singkat, dan referensi suara audio, lalu jelaskan bagian shot sasaran yang dipengaruhi masing-masing. Nyatakan detail pakaian, lingkungan, atau objek yang harus tetap dapat dikenali. Bandingkan klip akhir dengan persyaratan tersebut, termasuk kesinambungan gerak dan hubungan antara penutur yang terlihat dengan suara yang terdengar.\n\nUcapan, bunyi, dan pengaturan waktu shot\n\nH3 memodelkan dialog, bunyi fisik, suasana, dan musik bersama. Kartu model mendokumentasikan dukungan dialog stabil untuk bahasa Arab, Tionghoa, Inggris, Prancis, Jerman, Italia, Jepang, Korea, Portugis, Rusia, dan Spanyol; bahasa lain digambarkan memiliki dukungan yang bervariasi. Berikan kata-kata lisan serta bahasa yang persis, dengan identitas penutur yang stabil antarshot.\n\nPanduan penulisan prompt pembuatnya menggunakan bahasa Inggris untuk bagian deskriptif sambil mempertahankan dialog serta teks visual dalam bahasa aslinya. Konten lisan menggunakan `[Language] ...`, dengan identitas penutur dan deskripsi suara di luar blok. Bedakan ucapan fisik dari sulih suara di luar layar, dan identifikasi kapan kalimat berlanjut melewati potongan shot atau terputus oleh akhir. Pertahankan teks visual secara persis juga. Sesuaikan jumlah ucapan dengan durasi pilihan dan periksa kata-kata yang dirender serta kalimat yang terdengar bersama.\n\nJelaskan gerak kamera sebagai tindakan, termasuk rentang dan kecepatannya ketika penting. Beri nomor shot menurut urutan pemutaran dan jaga waktu potongan berada dalam durasi video. Pisahkan bunyi adegan seperti langkah kaki atau pintu menutup dari musik latar yang hanya terdengar bagi audiens. Pilihan ini membuat rencana shot singkat lebih mudah ditafsirkan serta ditinjau terhadap hasilnya.\n\nPersiapan masukan dan batas numerik\n\nSkema generasi saat ini mewajibkan teks yang tidak kosong dalam setiap mode, hingga 7.000 karakter per item teks. Gambar dapat berupa JPG, JPEG, PNG, WebP, HEIC, atau HEIF, masing-masing hingga 30 MB, dengan setiap sisi dari 256 hingga 5.760 piksel dan rasio aspek dari 0,4 hingga 2,5. Masukan bingkai mengizinkan satu gambar pembuka dan satu penutup; mode referensi mengizinkan hingga sembilan gambar referensi.\n\nVideo referensi dapat memuat hingga tiga klip MP4 atau MOV, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Klip boleh hingga 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi dari 256 hingga 5.760 piksel, rasio dari 0,4 hingga 2,5, dan laju bingkai dari 23,976 hingga 60. Audio referensi mendukung hingga tiga klip WAV atau MP3, masing-masing hingga 15 MB, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Kartu model membatasi masukan referensi campuran hingga 12 berkas. Batas badan permintaan yang didokumentasikan adalah 64 MB, terpisah dari batas per berkas.\n\nPilih hanya referensi yang berkontribusi pada arahan dan perjelas setiap kontribusi. Tampilan subjek yang jelas lebih berguna daripada beberapa tampilan yang bertentangan tanpa penjelasan. Pertahankan urutan referensi, pangkas materi tidak relevan tanpa menghilangkan konteks adegan yang diperlukan, dan periksa bahwa klip sumber singkat memuat tindakan atau karakteristik suara yang diminta.\n\nBentuk keluaran dan sistem lengkap\n\nAntarmuka H3 produsen menawarkan 768P dan 2K. Generasi hanya teks memerlukan rasio konkret: 21:9, 16:9, 4:3, 1:1, 3:4, atau 9:16. Kreasi bingkai pertama/terakhir mengambil rasio aspek dari gambar masukan; kreasi referensi dapat menggunakan rasio adaptif atau eksplisit. Durasi keluaran dalam bilangan bulat adalah 4–15 detik.\n\nKartu model membedakan H3-Context-IR, yang menafsirkan dan memperkaya arahan, H3-Base, yang menghasilkan konten audiovisual, serta H3-Regenerate-2K, yang menciptakan hasil beresolusi lebih tinggi. Checkpoint dasar yang dirilis memisahkan tugas berpanduan bingkai dan omni-reference. Komponen konteks serta regenerasi berbeda dari bobot dasar itu, sehingga nama checkpoint terbuka saja tidak membuktikan perilaku seluruh sistem.\n\nAlur kerja generasi pembuatnya bersifat asinkron. Antarmuka kueri tugasnya mengambil tugas dari tujuh hari sebelumnya. Simpan identitas tugas hingga hasil video sebenarnya dikembalikan, lalu simpan klip, alih-alih hanya mempertahankan alamat unduhan berbatas waktu. Tinjau identitas visual, teks kecil, interaksi objek, konten lisan, dan waktu bunyi pada ukuran tontonan yang dimaksud. Produsen mengidentifikasi pemahaman multimodal serta detail visual halus sebagai area yang terus ditingkatkan; arahan terperinci dan perbandingan sumber tetap menjadi inti hasil yang berguna.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "4ca6d65f49eafbdd03efe40d1b52c56d8cbc55fe3b4ef3b20ddbc23ca62dc9ff", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "id", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Mulai

MiniMax H3 menghasilkan video pendek dengan audio stereo bawaan dari teks, gambar bingkai, atau referensi multimodal. Model ini mendukung kreasi bingkai pertama/terakhir, penyuntingan berpanduan referensi, dan hubungan gerak atau suara, dengan keluaran 4–15 detik serta alur kerja regenerasi 2K yang terpisah.

Masukan yang diterima
Teks · Gambar · Audio · Video
Hasil
Video
Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

Satu hasil audiovisual dari arahan multimodal

MiniMax H3 adalah sistem video omni-modal MiniMax. Sistem ini menafsirkan teks, gambar, video, dan audio bersama, lalu menghasilkan video dengan bunyi stereo bawaan. Pembuatnya menyajikannya untuk karya kreatif singkat seperti visual produk, periklanan, poster animasi, dan konsep judul film, ketika hubungan antar aset referensi sama pentingnya dengan deskripsi adegan.

Sistem yang didokumentasikan menghasilkan video 4–15 detik pada 24 bingkai per detik dengan audio stereo 32 kHz. Generasi H3-Base beroperasi pada 768p; alur kerja 2K penuh meregenerasi hasil itu menggunakan konteks multimodal asli. Ini lebih dari pengubahan ukuran konvensional: tahap kedua menggunakan model dan konteks sumber lagi untuk memulihkan detail halus. H3 Max dan H3-Context-IR memiliki peran serta batas terpisah.

Kreasi teks dan berpanduan bingkai

Masukan hanya teks menjelaskan seluruh linimasa audiovisual. Gambar pertama menambatkan pembukaan, gambar terakhir menambatkan penutup, dan dua gambar dapat menentukan keduanya. Untuk shot bingkai pertama, mulailah dengan komposisi serta identitas yang terlihat dalam gambar diam, lalu jelaskan tindakan yang berkembang darinya. Untuk transisi bingkai pertama ke terakhir, jelaskan gerakan yang dapat diamati yang menghubungkan kedua keadaan, alih-alih mengulangi dua deskripsi gambar yang tidak berkaitan.

Arahan produk praktis dapat menentukan kemasan tertutup dalam bingkai pembuka, tangan yang membukanya, gerak kamera lembut, dan keadaan akhir yang harus dicapai. Pertahankan bentuk objek, penempatan label, serta pencahayaan dalam bingkai yang diberikan. Kreasi berpanduan bingkai dan kreasi berpanduan referensi merupakan mode masukan terpisah; antarmuka pembuatnya tidak mencampurkan peran bingkai pertama/terakhir dengan peran media referensi dalam satu permintaan.

Generasi dan penyuntingan berpanduan referensi

Mode referensi menerima teks dengan gambar, klip video, dan klip audio. Identifikasi kontribusi setiap sumber: penampilan karakter, lokasi, gerak kamera, struktur waktu klip sumber, atau suara. Video yang hanya digunakan untuk gerak kamera berbeda dari video yang benar-benar perlu disunting atau dilanjutkan. Nyatakan hubungan itu secara eksplisit.

Panduan referensi pembuatnya memisahkan definisi subjek, ringkasan tugas, analisis pemertahanan, deskripsi shot terperinci, lanskap bunyi keseluruhan, dan musik latar yang hanya didengar audiens. Panduan membedakan pemertahanan konten visual dari transfer atribut atau referensi gaya yang luas. Untuk audio, menyalin sinyal berbeda dari merujuk timbre, irama, atau penyampaian. Pertahankan kestabilan peran tersebut di seluruh arahan.

Untuk adegan berbasis referensi, berikan gambar karakter, referensi gerak kamera singkat, dan referensi suara audio, lalu jelaskan bagian shot sasaran yang dipengaruhi masing-masing. Nyatakan detail pakaian, lingkungan, atau objek yang harus tetap dapat dikenali. Bandingkan klip akhir dengan persyaratan tersebut, termasuk kesinambungan gerak dan hubungan antara penutur yang terlihat dengan suara yang terdengar.

Ucapan, bunyi, dan pengaturan waktu shot

H3 memodelkan dialog, bunyi fisik, suasana, dan musik bersama. Kartu model mendokumentasikan dukungan dialog stabil untuk bahasa Arab, Tionghoa, Inggris, Prancis, Jerman, Italia, Jepang, Korea, Portugis, Rusia, dan Spanyol; bahasa lain digambarkan memiliki dukungan yang bervariasi. Berikan kata-kata lisan serta bahasa yang persis, dengan identitas penutur yang stabil antarshot.

Panduan penulisan prompt pembuatnya menggunakan bahasa Inggris untuk bagian deskriptif sambil mempertahankan dialog serta teks visual dalam bahasa aslinya. Konten lisan menggunakan <d>[Language] ...</d>, dengan identitas penutur dan deskripsi suara di luar blok. Bedakan ucapan fisik dari sulih suara di luar layar, dan identifikasi kapan kalimat berlanjut melewati potongan shot atau terputus oleh akhir. Pertahankan teks visual secara persis juga. Sesuaikan jumlah ucapan dengan durasi pilihan dan periksa kata-kata yang dirender serta kalimat yang terdengar bersama.

Jelaskan gerak kamera sebagai tindakan, termasuk rentang dan kecepatannya ketika penting. Beri nomor shot menurut urutan pemutaran dan jaga waktu potongan berada dalam durasi video. Pisahkan bunyi adegan seperti langkah kaki atau pintu menutup dari musik latar yang hanya terdengar bagi audiens. Pilihan ini membuat rencana shot singkat lebih mudah ditafsirkan serta ditinjau terhadap hasilnya.

Persiapan masukan dan batas numerik

Skema generasi saat ini mewajibkan teks yang tidak kosong dalam setiap mode, hingga 7.000 karakter per item teks. Gambar dapat berupa JPG, JPEG, PNG, WebP, HEIC, atau HEIF, masing-masing hingga 30 MB, dengan setiap sisi dari 256 hingga 5.760 piksel dan rasio aspek dari 0,4 hingga 2,5. Masukan bingkai mengizinkan satu gambar pembuka dan satu penutup; mode referensi mengizinkan hingga sembilan gambar referensi.

Video referensi dapat memuat hingga tiga klip MP4 atau MOV, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Klip boleh hingga 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi dari 256 hingga 5.760 piksel, rasio dari 0,4 hingga 2,5, dan laju bingkai dari 23,976 hingga 60. Audio referensi mendukung hingga tiga klip WAV atau MP3, masing-masing hingga 15 MB, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Kartu model membatasi masukan referensi campuran hingga 12 berkas. Batas badan permintaan yang didokumentasikan adalah 64 MB, terpisah dari batas per berkas.

Pilih hanya referensi yang berkontribusi pada arahan dan perjelas setiap kontribusi. Tampilan subjek yang jelas lebih berguna daripada beberapa tampilan yang bertentangan tanpa penjelasan. Pertahankan urutan referensi, pangkas materi tidak relevan tanpa menghilangkan konteks adegan yang diperlukan, dan periksa bahwa klip sumber singkat memuat tindakan atau karakteristik suara yang diminta.

Bentuk keluaran dan sistem lengkap

Antarmuka H3 produsen menawarkan 768P dan 2K. Generasi hanya teks memerlukan rasio konkret: 21:9, 16:9, 4:3, 1:1, 3:4, atau 9:16. Kreasi bingkai pertama/terakhir mengambil rasio aspek dari gambar masukan; kreasi referensi dapat menggunakan rasio adaptif atau eksplisit. Durasi keluaran dalam bilangan bulat adalah 4–15 detik.

Kartu model membedakan H3-Context-IR, yang menafsirkan dan memperkaya arahan, H3-Base, yang menghasilkan konten audiovisual, serta H3-Regenerate-2K, yang menciptakan hasil beresolusi lebih tinggi. Checkpoint dasar yang dirilis memisahkan tugas berpanduan bingkai dan omni-reference. Komponen konteks serta regenerasi berbeda dari bobot dasar itu, sehingga nama checkpoint terbuka saja tidak membuktikan perilaku seluruh sistem.

Alur kerja generasi pembuatnya bersifat asinkron. Antarmuka kueri tugasnya mengambil tugas dari tujuh hari sebelumnya. Simpan identitas tugas hingga hasil video sebenarnya dikembalikan, lalu simpan klip, alih-alih hanya mempertahankan alamat unduhan berbatas waktu. Tinjau identitas visual, teks kecil, interaksi objek, konten lisan, dan waktu bunyi pada ukuran tontonan yang dimaksud. Produsen mengidentifikasi pemahaman multimodal serta detail visual halus sebagai area yang terus ditingkatkan; arahan terperinci dan perbandingan sumber tetap menjadi inti hasil yang berguna.

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Video POST /v1/videos
Masukan
text, image, audio, video
Keluaran
video
Format keluaran
byte MP4 asli; tanpa normalisasi atau pengodean ulang
KolomJenisPersyaratanNilai & batasanBawaan
KolommodelJenisstringPersyaratanWajibNilai & batasan
minimax/hailuo-3
Bawaan—
KolompromptJenisstringPersyaratanWajibNilai & batasanBawaan—
KolomdurationJenisintegerPersyaratanWajibNilai & batasan
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maksimum: 600
Bawaan—
KolomresolutionJenisstringPersyaratanOpsionalNilai & batasan
2K
Bawaan—
Kolomaspect_ratioJenisstringPersyaratanOpsionalNilai & batasan
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Bawaan—
Kolomgenerate_audioJenisbooleanPersyaratanOpsionalNilai & batasan
false, true
Bawaan—
Kolomframe_imagesJenisarrayPersyaratanOpsionalNilai & batasan
Item minimum: 1
Item maksimum: 2
Konten masukan: Array objek bingkai. Setiap objek memiliki type=image_url, image_url yang memuat url, dan frame_type. Gunakan URL gambar HTTPS dan tetapkan frame_type ke first_frame atau last_frame. Setiap peran bingkai muncul paling banyak sekali.
Kunci persis: type, image_url, frame_type
Kondisi: Kunci-kunci ini menjelaskan setiap objek bingkai; image_url hanya memuat url. Hilangkan frame_images untuk permintaan yang hanya berisi teks.
Bawaan—
Kolominput_referencesJenisarrayPersyaratanOpsionalNilai & batasanBawaan—
Kolomcallback_urlJenisstringPersyaratanOpsionalNilai & batasan
Pola: ^https://
Bawaan—
Kolomsession_idJenisstringPersyaratanOpsionalNilai & batasanBawaan—
KolomtraceJenisobjectPersyaratanOpsionalNilai & batasanBawaan—
KolomuserJenisstringPersyaratanOpsionalNilai & batasanBawaan—
Kombinasi bahan masukan

Teks ke video · Prompt tertulis. · Wajib: model, prompt, duration

Berikan prompt sebagai teks dan durasi dalam detik bulat. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.

model: Jenis: string · minimax/hailuo-3

prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya

Gambar ke video · Prompt tertulis dan satu gambar bingkai pertama. · Wajib: model, prompt, duration, frame_images

frame_images berupa array. Setiap objek bingkai memiliki type, image_url, dan frame_type; image_url memuat url. Tetapkan type ke image_url. Gunakan first_frame dengan last_frame opsional. Setiap peran bingkai muncul paling banyak sekali. Berikan URL gambar HTTPS publik untuk setiap bingkai. Gunakan gambar bingkai atau gambar referensi dalam satu permintaan; jangan gabungkan keduanya. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.

Kunci persis: type, image_url, frame_type

model: Jenis: string · minimax/hailuo-3

prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya

Reference to video · Prompt tertulis dan referensi gambar, video, audio yang didukung. · Wajib: model, prompt, duration, input_references

input_references adalah array objek. Tetapkan type ke image_url, video_url, audio_url, dan gunakan bidang yang sesuai yang memuat url. Gunakan URL HTTPS publik. Hilangkan frame_images untuk memilih mode referensi. Perkiraan hanya mencakup komponen per gambar yang ditampilkan untuk gambar referensi setelah lima gambar pertama. Tagihan akhir mengikuti konfigurasi aktual yang ditagihkan. Jangan gabungkan gambar referensi dengan gambar bingkai. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.

model: Jenis: string · minimax/hailuo-3

prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya

Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt, duration
Parametermaterial_typesKontraktext, image, audio, video
Parameteradditional_propertiesKontrakfalse
Parameteroptional_controlsKontrakresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Siklus hidup: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Paket

Cara menghitung biaya akhir

Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast
Tidak ditentukan Saat mode fast dipilih
Mode Flex
Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum
Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

KonfigurasiJadwal tarifJumlah perkiraanSatuan penagihanKondisi penagihanBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarJumlah perkiraan—Satuan penagihan—Kondisi penagihan—Biaya
Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token
Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanTidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini.Biaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.26 per detik video
Konfigurasigambar referensiJadwal tarif—Jumlah perkiraan—Satuan penagihanper gambar referensiKondisi penagihan—Biaya
Masukan · gambar referensi · Perkiraan hanya untuk perbandingan $0.08 per gambar referensi
KonfigurasiPerkiraan biaya pembuatanJadwal tarif—Jumlah perkiraanestimasi satu kali pembuatanSatuan penagihan—Kondisi penagihan—Biaya
Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $1.3 estimasi sebelum pembuatan

Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Detail tarif referensi

Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.

Referensi harga konfigurasi video

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

KonfigurasiKondisi penagihanBiaya
KonfigurasiHarga videoKondisi penagihanTidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini.Biaya
Keluaran · Harga video $0.26 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

KonfigurasiGambar referensi setelah lima gambar pertamaKondisi penagihanTidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini.Biaya
Masukan · Gambar referensi setelah lima gambar pertama $0.08 per gambar

Lima gambar referensi pertama gratis; tarif per gambar yang tercantum berlaku setelah lima gambar pertama. Referensi harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Tagihan akhir mengikuti konfigurasi aktual yang ditagihkan.

Contoh permintaan

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Terima dan simpan hasil

Ailoot Ultra · Video

URL konten bertanda tangan milik Ailoot

Periksa status tugas
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Pembacaan konten lain
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Simpan semua hasil yang selesai

Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.

Simpan setiap keluaran aktual milik Ailoot beserta metadata hasil pengukuran yang dikembalikan.

Jika respons asli perlu diperiksa

503 result_pending_check + id asli + X-Should-Retry:false; jangan pernah ulangi pengiriman awal

Kolom respons
KolomJenisArti
KolomindexJenisintegerArtiPosisi video ini dalam daftar keluaran, dihitung dari nol.
Kolomcontent_urlJenisstringArtiURL unduhan HTTPS bertanda tangan untuk video yang telah selesai ini.
Kolomsha256Jenisstring | nullArtiDigest SHA-256 dari byte video asli; null jika tidak tersedia.
Kolomsize_bytesJenisinteger | nullArtiUkuran berkas video asli dalam byte; null jika tidak tersedia.
Kolomduration_msJenisinteger | nullArtiDurasi video terukur dalam milidetik; null jika tidak tersedia.
KolomwidthJenisinteger | nullArtiLebar video dalam piksel; null jika tidak tersedia.
KolomheightJenisinteger | nullArtiTinggi video dalam piksel; null jika tidak tersedia.
Kolomvideo_codecJenisstring | nullArtiPengenal codec video; null jika tidak dicatat.
Kolomhas_audioJenisboolean | nullArtiApakah video memuat trek audio; null jika tidak diukur.
Kolomaudio_codecJenisstring | nullArtiPengenal codec audio; null jika tidak ada pengenal yang dicatat.
Kesalahan dan langkah berikutnya
ResponsKondisiLangkah berikutnya
Respons404 · not_found_errorKondisiAkses video tidak tersedia, atau ID video ini tidak ditemukan.Langkah berikutnyaPeriksa akses video. Untuk video yang sudah ada, gunakan ID publik aslinya dan kunci API yang sama.
Respons401 · authentication_errorKondisiKunci API tidak cocok dengan akun yang diautentikasi.Langkah berikutnyaPeriksa kunci API dan akses akun Anda sebelum mengirim.
Respons400 · invalid_request_errorKondisiPermintaan tidak dapat dibaca, atau indeks unduhan tidak valid.Langkah berikutnyaPerbaiki isi permintaan. Untuk unduhan, pilih indeks keluaran yang dikembalikan oleh tugas awal.
Respons422 · price_unavailableKondisiHarga konfigurasi video yang dipilih tidak dapat dihitung.Langkah berikutnyaPilih konfigurasi video yang didukung dan lengkapi opsi wajibnya sebelum mengirim permintaan yang telah diperbaiki.
Respons422 · invalid_request_errorKondisiMasukan video atau tugas kelanjutan awal tidak valid.Langkah berikutnyaGunakan masukan HTTPS yang valid. Untuk kelanjutan, gunakan ID video publik awal Anda yang telah selesai dengan kunci API yang sama.
Respons402 · billing_errorKondisiSaldo atau batas yang tersedia tidak memungkinkan pencadangan dana.Langkah berikutnyaPeriksa saldo dan batas yang tersedia sebelum mengirim permintaan baru.
Respons503 · server_errorKondisiVerifikasi video, penyimpanan, atau akses layanan sementara tidak tersedia.Langkah berikutnyaTunggu hingga layanan tersedia. Jika Anda sudah memiliki ID video, periksa tugas awal tersebut alih-alih memulai pembuatan baru.
Respons503 · result_pending_checkKondisiHasil video awal dan tagihannya perlu diperiksa.Langkah berikutnyaSimpan ID video yang dikembalikan dan periksa tugas tersebut. Jangan kirim permintaan pembuatan pengganti selama tugas itu sedang diperiksa.
Respons503 · owned_result_unavailableKondisiUnduhan video yang sudah ada sementara tidak tersedia.Langkah berikutnyaPeriksa tugas video yang sama nanti dan unduh keluaran yang sudah ada. Pembuatan baru menghasilkan operasi terpisah.
Respons409 · video_not_readyKondisiKonten video belum dipublikasikan.Langkah berikutnyaPeriksa status tugas awal. Unduh setelah statusnya completed; jika statusnya failed, ikuti pemberitahuan pemeriksaan tagihannya.

Alias

Alias model

Ailoot Ultra minimax/hailuo-3

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

minimax/hailuo-3

", "method_identity": { "effective_request_model_id": "minimax/hailuo-3", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|minimax%2Fhailuo-3", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Simpan setiap keluaran aktual milik Ailoot beserta metadata hasil pengukuran yang dikembalikan.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Akses video tidak tersedia, atau ID video ini tidak ditemukan.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Periksa akses video. Untuk video yang sudah ada, gunakan ID publik aslinya dan kunci API yang sama.", "type": "not_found_error" }, { "condition": "Kunci API tidak cocok dengan akun yang diautentikasi.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Periksa kunci API dan akses akun Anda sebelum mengirim.", "type": "authentication_error" }, { "condition": "Permintaan tidak dapat dibaca, atau indeks unduhan tidak valid.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Perbaiki isi permintaan. Untuk unduhan, pilih indeks keluaran yang dikembalikan oleh tugas awal.", "type": "invalid_request_error" }, { "condition": "Harga konfigurasi video yang dipilih tidak dapat dihitung.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Pilih konfigurasi video yang didukung dan lengkapi opsi wajibnya sebelum mengirim permintaan yang telah diperbaiki.", "type": "price_unavailable" }, { "condition": "Masukan video atau tugas kelanjutan awal tidak valid.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gunakan masukan HTTPS yang valid. Untuk kelanjutan, gunakan ID video publik awal Anda yang telah selesai dengan kunci API yang sama.", "type": "invalid_request_error" }, { "condition": "Saldo atau batas yang tersedia tidak memungkinkan pencadangan dana.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Periksa saldo dan batas yang tersedia sebelum mengirim permintaan baru.", "type": "billing_error" }, { "condition": "Verifikasi video, penyimpanan, atau akses layanan sementara tidak tersedia.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Tunggu hingga layanan tersedia. Jika Anda sudah memiliki ID video, periksa tugas awal tersebut alih-alih memulai pembuatan baru.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Hasil video awal dan tagihannya perlu diperiksa.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Simpan ID video yang dikembalikan dan periksa tugas tersebut. Jangan kirim permintaan pembuatan pengganti selama tugas itu sedang diperiksa.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Unduhan video yang sudah ada sementara tidak tersedia.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Periksa tugas video yang sama nanti dan unduh keluaran yang sudah ada. Pembuatan baru menghasilkan operasi terpisah.", "type": "server_error" }, { "condition": "Konten video belum dipublikasikan.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Periksa status tugas awal. Unduh setelah statusnya completed; jika statusnya failed, ikuti pemberitahuan pemeriksaan tagihannya.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id asli + X-Should-Retry:false; jangan pernah ulangi pengiriman awal" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Berikan prompt sebagai teks dan durasi dalam detik bulat. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt tertulis." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images berupa array. Setiap objek bingkai memiliki type, image_url, dan frame_type; image_url memuat url. Tetapkan type ke image_url. Gunakan first_frame dengan last_frame opsional. Setiap peran bingkai muncul paling banyak sekali. Berikan URL gambar HTTPS publik untuk setiap bingkai. Gunakan gambar bingkai atau gambar referensi dalam satu permintaan; jangan gabungkan keduanya. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt tertulis dan satu gambar bingkai pertama." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references adalah array objek. Tetapkan type ke image_url, video_url, audio_url, dan gunakan bidang yang sesuai yang memuat url. Gunakan URL HTTPS publik. Hilangkan frame_images untuk memilih mode referensi. Perkiraan hanya mencakup komponen per gambar yang ditampilkan untuk gambar referensi setelah lima gambar pertama. Tagihan akhir mengikuti konfigurasi aktual yang ditagihkan. Jangan gabungkan gambar referensi dengan gambar bingkai. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Prompt tertulis dan referensi gambar, video, audio yang didukung." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posisi video ini dalam daftar keluaran, dihitung dari nol.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL unduhan HTTPS bertanda tangan untuk video yang telah selesai ini.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Digest SHA-256 dari byte video asli; null jika tidak tersedia.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Ukuran berkas video asli dalam byte; null jika tidak tersedia.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durasi video terukur dalam milidetik; null jika tidak tersedia.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Lebar video dalam piksel; null jika tidak tersedia.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Tinggi video dalam piksel; null jika tidak tersedia.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Pengenal codec video; null jika tidak dicatat.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Apakah video memuat trek audio; null jika tidak diukur.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Pengenal codec audio; null jika tidak ada pengenal yang dicatat.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL konten bertanda tangan milik Ailoot", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Kunci-kunci ini menjelaskan setiap objek bingkai; image_url hanya memuat url. Hilangkan frame_images untuk permintaan yang hanya berisi teks.", "content": "Array objek bingkai. Setiap objek memiliki type=image_url, image_url yang memuat url, dan frame_type. Gunakan URL gambar HTTPS dan tetapkan frame_type ke first_frame atau last_frame. Setiap peran bingkai muncul paling banyak sekali.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Perkiraan biaya pembuatan", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "minimax/hailuo-3", "nativeProvenance": { "input_facts_canonical_sha256": "3756226aea203162137779a3a698552df79b9d61ead1f7d73f2498c28e59d62d", "input_html_sha256": "c2fa3366d86588108e03ad28ad75b7b19e18c3179a140b7ad356b7733daa1406", "private_audit_sha256": "2bbe07180fe99d84c2f8f9092b21fbf03ec8c01d26093b1846f859ee6ae0764b", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/id/minimax-hailuo-3/", "description": "MiniMax H3 menghasilkan video pendek dengan audio stereo bawaan dari teks, gambar bingkai, atau referensi multimodal. Model ini mendukung kreasi bingkai pertama/terakhir, penyuntingan berpanduan referensi, dan hubungan gerak atau suara, dengan keluaran 4–15 detik serta alur kerja regenerasi 2K yang terpisah.", "locale": "id", "md_url": "https://ailoot.ai/models/id/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/id/minimax-hailuo-3/" }, "rawModel": { "about": "Satu hasil audiovisual dari arahan multimodal\n\nMiniMax H3 adalah sistem video omni-modal MiniMax. Sistem ini menafsirkan teks, gambar, video, dan audio bersama, lalu menghasilkan video dengan bunyi stereo bawaan. Pembuatnya menyajikannya untuk karya kreatif singkat seperti visual produk, periklanan, poster animasi, dan konsep judul film, ketika hubungan antar aset referensi sama pentingnya dengan deskripsi adegan.\n\nSistem yang didokumentasikan menghasilkan video 4–15 detik pada 24 bingkai per detik dengan audio stereo 32 kHz. Generasi H3-Base beroperasi pada 768p; alur kerja 2K penuh meregenerasi hasil itu menggunakan konteks multimodal asli. Ini lebih dari pengubahan ukuran konvensional: tahap kedua menggunakan model dan konteks sumber lagi untuk memulihkan detail halus. H3 Max dan H3-Context-IR memiliki peran serta batas terpisah.\n\nKreasi teks dan berpanduan bingkai\n\nMasukan hanya teks menjelaskan seluruh linimasa audiovisual. Gambar pertama menambatkan pembukaan, gambar terakhir menambatkan penutup, dan dua gambar dapat menentukan keduanya. Untuk shot bingkai pertama, mulailah dengan komposisi serta identitas yang terlihat dalam gambar diam, lalu jelaskan tindakan yang berkembang darinya. Untuk transisi bingkai pertama ke terakhir, jelaskan gerakan yang dapat diamati yang menghubungkan kedua keadaan, alih-alih mengulangi dua deskripsi gambar yang tidak berkaitan.\n\nArahan produk praktis dapat menentukan kemasan tertutup dalam bingkai pembuka, tangan yang membukanya, gerak kamera lembut, dan keadaan akhir yang harus dicapai. Pertahankan bentuk objek, penempatan label, serta pencahayaan dalam bingkai yang diberikan. Kreasi berpanduan bingkai dan kreasi berpanduan referensi merupakan mode masukan terpisah; antarmuka pembuatnya tidak mencampurkan peran bingkai pertama/terakhir dengan peran media referensi dalam satu permintaan.\n\nGenerasi dan penyuntingan berpanduan referensi\n\nMode referensi menerima teks dengan gambar, klip video, dan klip audio. Identifikasi kontribusi setiap sumber: penampilan karakter, lokasi, gerak kamera, struktur waktu klip sumber, atau suara. Video yang hanya digunakan untuk gerak kamera berbeda dari video yang benar-benar perlu disunting atau dilanjutkan. Nyatakan hubungan itu secara eksplisit.\n\nPanduan referensi pembuatnya memisahkan definisi subjek, ringkasan tugas, analisis pemertahanan, deskripsi shot terperinci, lanskap bunyi keseluruhan, dan musik latar yang hanya didengar audiens. Panduan membedakan pemertahanan konten visual dari transfer atribut atau referensi gaya yang luas. Untuk audio, menyalin sinyal berbeda dari merujuk timbre, irama, atau penyampaian. Pertahankan kestabilan peran tersebut di seluruh arahan.\n\nUntuk adegan berbasis referensi, berikan gambar karakter, referensi gerak kamera singkat, dan referensi suara audio, lalu jelaskan bagian shot sasaran yang dipengaruhi masing-masing. Nyatakan detail pakaian, lingkungan, atau objek yang harus tetap dapat dikenali. Bandingkan klip akhir dengan persyaratan tersebut, termasuk kesinambungan gerak dan hubungan antara penutur yang terlihat dengan suara yang terdengar.\n\nUcapan, bunyi, dan pengaturan waktu shot\n\nH3 memodelkan dialog, bunyi fisik, suasana, dan musik bersama. Kartu model mendokumentasikan dukungan dialog stabil untuk bahasa Arab, Tionghoa, Inggris, Prancis, Jerman, Italia, Jepang, Korea, Portugis, Rusia, dan Spanyol; bahasa lain digambarkan memiliki dukungan yang bervariasi. Berikan kata-kata lisan serta bahasa yang persis, dengan identitas penutur yang stabil antarshot.\n\nPanduan penulisan prompt pembuatnya menggunakan bahasa Inggris untuk bagian deskriptif sambil mempertahankan dialog serta teks visual dalam bahasa aslinya. Konten lisan menggunakan `[Language] ...`, dengan identitas penutur dan deskripsi suara di luar blok. Bedakan ucapan fisik dari sulih suara di luar layar, dan identifikasi kapan kalimat berlanjut melewati potongan shot atau terputus oleh akhir. Pertahankan teks visual secara persis juga. Sesuaikan jumlah ucapan dengan durasi pilihan dan periksa kata-kata yang dirender serta kalimat yang terdengar bersama.\n\nJelaskan gerak kamera sebagai tindakan, termasuk rentang dan kecepatannya ketika penting. Beri nomor shot menurut urutan pemutaran dan jaga waktu potongan berada dalam durasi video. Pisahkan bunyi adegan seperti langkah kaki atau pintu menutup dari musik latar yang hanya terdengar bagi audiens. Pilihan ini membuat rencana shot singkat lebih mudah ditafsirkan serta ditinjau terhadap hasilnya.\n\nPersiapan masukan dan batas numerik\n\nSkema generasi saat ini mewajibkan teks yang tidak kosong dalam setiap mode, hingga 7.000 karakter per item teks. Gambar dapat berupa JPG, JPEG, PNG, WebP, HEIC, atau HEIF, masing-masing hingga 30 MB, dengan setiap sisi dari 256 hingga 5.760 piksel dan rasio aspek dari 0,4 hingga 2,5. Masukan bingkai mengizinkan satu gambar pembuka dan satu penutup; mode referensi mengizinkan hingga sembilan gambar referensi.\n\nVideo referensi dapat memuat hingga tiga klip MP4 atau MOV, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Klip boleh hingga 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi dari 256 hingga 5.760 piksel, rasio dari 0,4 hingga 2,5, dan laju bingkai dari 23,976 hingga 60. Audio referensi mendukung hingga tiga klip WAV atau MP3, masing-masing hingga 15 MB, masing-masing 2–15 detik dan bersama tidak lebih dari 15 detik. Kartu model membatasi masukan referensi campuran hingga 12 berkas. Batas badan permintaan yang didokumentasikan adalah 64 MB, terpisah dari batas per berkas.\n\nPilih hanya referensi yang berkontribusi pada arahan dan perjelas setiap kontribusi. Tampilan subjek yang jelas lebih berguna daripada beberapa tampilan yang bertentangan tanpa penjelasan. Pertahankan urutan referensi, pangkas materi tidak relevan tanpa menghilangkan konteks adegan yang diperlukan, dan periksa bahwa klip sumber singkat memuat tindakan atau karakteristik suara yang diminta.\n\nBentuk keluaran dan sistem lengkap\n\nAntarmuka H3 produsen menawarkan 768P dan 2K. Generasi hanya teks memerlukan rasio konkret: 21:9, 16:9, 4:3, 1:1, 3:4, atau 9:16. Kreasi bingkai pertama/terakhir mengambil rasio aspek dari gambar masukan; kreasi referensi dapat menggunakan rasio adaptif atau eksplisit. Durasi keluaran dalam bilangan bulat adalah 4–15 detik.\n\nKartu model membedakan H3-Context-IR, yang menafsirkan dan memperkaya arahan, H3-Base, yang menghasilkan konten audiovisual, serta H3-Regenerate-2K, yang menciptakan hasil beresolusi lebih tinggi. Checkpoint dasar yang dirilis memisahkan tugas berpanduan bingkai dan omni-reference. Komponen konteks serta regenerasi berbeda dari bobot dasar itu, sehingga nama checkpoint terbuka saja tidak membuktikan perilaku seluruh sistem.\n\nAlur kerja generasi pembuatnya bersifat asinkron. Antarmuka kueri tugasnya mengambil tugas dari tujuh hari sebelumnya. Simpan identitas tugas hingga hasil video sebenarnya dikembalikan, lalu simpan klip, alih-alih hanya mempertahankan alamat unduhan berbatas waktu. Tinjau identitas visual, teks kecil, interaksi objek, konten lisan, dan waktu bunyi pada ukuran tontonan yang dimaksud. Produsen mengidentifikasi pemahaman multimodal serta detail visual halus sebagai area yang terus ditingkatkan; arahan terperinci dan perbandingan sumber tetap menjadi inti hasil yang berguna.", "alias_of": null, "aliases": [], "author": "MiniMax", "available": null, "canonical_model": "minimax/hailuo-3", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Informasi lengkap harga konfigurasi tersedia di bagian detail." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "label": "Referensi harga konfigurasi video", "profiles": [ { "basis": "Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.", "dimensions": { "conditions": "Tidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini." }, "label": "Harga video", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] }, { "basis": "Lima gambar referensi pertama gratis; tarif per gambar yang tercantum berlaku setelah lima gambar pertama. Referensi harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Tagihan akhir mengikuti konfigurasi aktual yang ditagihkan.", "dimensions": { "conditions": "Tidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini." }, "label": "Gambar referensi setelah lima gambar pertama", "units": [ { "amount": "0.08", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Reference images after the first five", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_video_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "minimax/hailuo-3", "input": [ "text", "image", "audio", "video" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Simpan setiap keluaran aktual milik Ailoot beserta metadata hasil pengukuran yang dikembalikan.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Akses video tidak tersedia, atau ID video ini tidak ditemukan.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Periksa akses video. Untuk video yang sudah ada, gunakan ID publik aslinya dan kunci API yang sama.", "type": "not_found_error" }, { "condition": "Kunci API tidak cocok dengan akun yang diautentikasi.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Periksa kunci API dan akses akun Anda sebelum mengirim.", "type": "authentication_error" }, { "condition": "Permintaan tidak dapat dibaca, atau indeks unduhan tidak valid.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Perbaiki isi permintaan. Untuk unduhan, pilih indeks keluaran yang dikembalikan oleh tugas awal.", "type": "invalid_request_error" }, { "condition": "Harga konfigurasi video yang dipilih tidak dapat dihitung.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Pilih konfigurasi video yang didukung dan lengkapi opsi wajibnya sebelum mengirim permintaan yang telah diperbaiki.", "type": "price_unavailable" }, { "condition": "Masukan video atau tugas kelanjutan awal tidak valid.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gunakan masukan HTTPS yang valid. Untuk kelanjutan, gunakan ID video publik awal Anda yang telah selesai dengan kunci API yang sama.", "type": "invalid_request_error" }, { "condition": "Saldo atau batas yang tersedia tidak memungkinkan pencadangan dana.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Periksa saldo dan batas yang tersedia sebelum mengirim permintaan baru.", "type": "billing_error" }, { "condition": "Verifikasi video, penyimpanan, atau akses layanan sementara tidak tersedia.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Tunggu hingga layanan tersedia. Jika Anda sudah memiliki ID video, periksa tugas awal tersebut alih-alih memulai pembuatan baru.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Hasil video awal dan tagihannya perlu diperiksa.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Simpan ID video yang dikembalikan dan periksa tugas tersebut. Jangan kirim permintaan pembuatan pengganti selama tugas itu sedang diperiksa.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Unduhan video yang sudah ada sementara tidak tersedia.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Periksa tugas video yang sama nanti dan unduh keluaran yang sudah ada. Pembuatan baru menghasilkan operasi terpisah.", "type": "server_error" }, { "condition": "Konten video belum dipublikasikan.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Periksa status tugas awal. Unduh setelah statusnya completed; jika statusnya failed, ikuti pemberitahuan pemeriksaan tagihannya.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + id asli + X-Should-Retry:false; jangan pernah ulangi pengiriman awal" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Berikan prompt sebagai teks dan durasi dalam detik bulat. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt tertulis." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images berupa array. Setiap objek bingkai memiliki type, image_url, dan frame_type; image_url memuat url. Tetapkan type ke image_url. Gunakan first_frame dengan last_frame opsional. Setiap peran bingkai muncul paling banyak sekali. Berikan URL gambar HTTPS publik untuk setiap bingkai. Gunakan gambar bingkai atau gambar referensi dalam satu permintaan; jangan gabungkan keduanya. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt tertulis dan satu gambar bingkai pertama." }, { "mode": "Reference to video", "model": { "enum": [ "minimax/hailuo-3" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references adalah array objek. Tetapkan type ke image_url, video_url, audio_url, dan gunakan bidang yang sesuai yang memuat url. Gunakan URL HTTPS publik. Hilangkan frame_images untuk memilih mode referensi. Perkiraan hanya mencakup komponen per gambar yang ditampilkan untuk gambar referensi setelah lima gambar pertama. Tagihan akhir mengikuti konfigurasi aktual yang ditagihkan. Jangan gabungkan gambar referensi dengan gambar bingkai. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Prompt tertulis dan referensi gambar, video, audio yang didukung." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Posisi video ini dalam daftar keluaran, dihitung dari nol.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "URL unduhan HTTPS bertanda tangan untuk video yang telah selesai ini.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Digest SHA-256 dari byte video asli; null jika tidak tersedia.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Ukuran berkas video asli dalam byte; null jika tidak tersedia.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Durasi video terukur dalam milidetik; null jika tidak tersedia.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Lebar video dalam piksel; null jika tidak tersedia.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Tinggi video dalam piksel; null jika tidak tersedia.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Pengenal codec video; null jika tidak dicatat.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Apakah video memuat trek audio; null jika tidak diukur.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Pengenal codec audio; null jika tidak ada pengenal yang dicatat.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "URL konten bertanda tangan milik Ailoot", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "minimax/hailuo-3" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "minimax/hailuo-3" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "2K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "2K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Kunci-kunci ini menjelaskan setiap objek bingkai; image_url hanya memuat url. Hilangkan frame_images untuk permintaan yang hanya berisi teks.", "content": "Array objek bingkai. Setiap objek memiliki type=image_url, image_url yang memuat url, dan frame_type. Gunakan URL gambar HTTPS dan tetapkan frame_type ke first_frame atau last_frame. Setiap peran bingkai muncul paling banyak sekali.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "21:9", "16:9", "4:3", "1:1", "3:4", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "video_url" }, "video_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" } }, "required": [ "type", "video_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "minimax/hailuo-3" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "2K" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": false, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Frame images plus image references are rejected because mixed additive input count is unproved; pure frame or pure reference mode remains separately priced." ] }, "unsupported": [ "size", "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio", "video" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Perkiraan biaya pembuatan", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"minimax/hailuo-3\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"2K\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio", "video" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "dimensions": { "quoted_unit": "per reference image" }, "label": "reference image", "units": [ { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "minimax/hailuo-3", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.26", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per reference image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "reference_images" }, { "amount": "1.3", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.3", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "minimax/hailuo-3", "request_model_id": "minimax/hailuo-3", "route_label": "Ultra" } ], "name": "MiniMax: H3", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.3, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.3, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "768P" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "input_materials_additive": true, "resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_output_video_second", "conditions": { "input_materials_additive": true, "resolution": "2K" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "768P" }, "label": "Ultra", "units": [ { "amount": "0.16", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "768P" }, "key": "input_video", "label": "input video", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "output_resolution": "2K" }, "label": "Ultra", "units": [ { "amount": "0.26", "amount_unit": "usd_per_input_video_second", "conditions": { "adds_to_output": true, "output_resolution": "2K" }, "key": "input_video", "label": "input video", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_input_image", "conditions": { "adds_to_output": true, "first_free_reference_images": 5, "only_additional_images_charged": true, "reference_audio_free": true }, "key": "input_image", "label": "input image", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "in", "unit": "input_image" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.26", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.26", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.26", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" }, { "amount": "0.08", "amount_unit": "usd_per_exact_physical_unit", "basis": "reference image", "billing_original_currency": "USD", "billing_original_rate": "0.08", "key": "reference_images", "label": "reference image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "quantity": 1, "side": "in", "unit": "reference_image" } ] } ], "public_id": "minimax/hailuo-3", "short": "MiniMax H3 menghasilkan video pendek dengan audio stereo bawaan dari teks, gambar bingkai, atau referensi multimodal. Model ini mendukung kreasi bingkai pertama/terakhir, penyuntingan berpanduan referensi, dan hubungan gerak atau suara, dengan keluaran 4–15 detik serta alur kerja regenerasi 2K yang terpisah." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "MiniMax H3 menghasilkan video pendek dengan audio stereo bawaan dari teks, gambar bingkai, atau referensi multimodal. Model ini mendukung kreasi bingkai pertama/terakhir, penyuntingan berpanduan referensi, dan hubungan gerak atau suara, dengan keluaran 4–15 detik serta alur kerja regenerasi 2K yang terpisah.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "eee028193db5ab6c9d587d7380d9ce3db5ed2bad2d78774a0e4e8ba69adb9aa0", "renderer_sha256": "2a0471475a29000c23db326ca1e315df73dee7524f6bc2907818ee3458813f2d" }, "sourceRevision": "3fcac4e7459afc76d202e15d4a4b320dabfb378a19f387c1a184de4453ccfb17" }