{ "aboutHtml": "

Satu hasil audiovisual daripada taklimat multimodal

MiniMax H3 ialah sistem video omni-modal MiniMax. Ia mentafsir teks, imej, video dan audio bersama-sama, kemudian menjana video dengan bunyi stereo natif. Pembuat mempersembahkannya untuk kerja kreatif pendek seperti visual produk, pengiklanan, poster beranimasi dan konsep tajuk filem, apabila hubungan antara aset rujukan sama penting dengan penerangan adegan.

Sistem yang didokumentasikan menghasilkan video 4–15 saat pada 24 bingkai sesaat dengan audio stereo 32 kHz. Penjanaan H3-Base beroperasi pada 768p; aliran kerja penuh 2K menjana semula hasil itu menggunakan konteks multimodal asal. Ini lebih daripada ubah saiz lazim: peringkat kedua menggunakan semula model dan konteks sumber untuk memulihkan butiran halus. H3 Max dan H3-Context-IR mempunyai peranan serta had berasingan.

Penciptaan berpandukan teks dan bingkai

Input teks sahaja menerangkan seluruh garis masa audiovisual. Imej pertama menetapkan pembukaan, imej terakhir menetapkan penutup, dan dua imej boleh menentukan kedua-duanya. Untuk syot bingkai pertama, mulakan dengan komposisi dan identiti yang kelihatan dalam imej pegun, kemudian terangkan tindakan yang berkembang daripadanya. Untuk peralihan bingkai pertama ke terakhir, terangkan pergerakan yang dapat diperhatikan yang menghubungkan dua keadaan, bukannya mengulang dua penerangan imej yang tidak berkaitan.

Taklimat produk praktikal boleh menetapkan bungkusan tertutup dalam bingkai pembukaan, tangan yang membukanya, gerakan kamera lembut dan keadaan akhir yang perlu dicapai. Kekalkan bentuk objek, peletakan label dan pencahayaan dalam bingkai yang dibekalkan. Penciptaan berpandukan bingkai dan penciptaan berpandukan rujukan ialah mod input berasingan; antara muka pembuat tidak mencampurkan peranan bingkai pertama/terakhir dengan peranan media rujukan dalam satu permintaan.

Penjanaan dan penyuntingan berpandukan rujukan

Mod rujukan menerima teks bersama imej, klip video dan klip audio. Kenal pasti sumbangan setiap sumber: rupa watak, lokasi, gerak kamera, struktur masa klip sumber atau suara. Video yang digunakan hanya untuk gerak kamera berbeza daripada video yang benar-benar patut disunting atau disambung. Nyatakan hubungan itu secara jelas.

Panduan rujukan pembuat mengasingkan takrif subjek, ringkasan tugas, analisis pengekalan, penerangan syot terperinci, landskap bunyi keseluruhan dan muzik latar yang hanya didengar khalayak. Ia membezakan pengekalan kandungan yang kelihatan daripada pemindahan atribut atau rujukan gaya luas. Untuk audio, menyalin isyarat berbeza daripada merujuk timbre, ritma atau penyampaian. Kekalkan kestabilan peranan itu sepanjang taklimat.

Untuk adegan berpandukan rujukan, bekalkan imej watak, rujukan gerak kamera pendek dan rujukan suara audio, kemudian terangkan tempat setiap satu patut mempengaruhi syot sasaran. Nyatakan butiran pakaian, persekitaran atau objek yang mesti kekal dapat dikenali. Bandingkan klip siap dengan keperluan itu, termasuk kesinambungan gerakan dan hubungan antara penutur yang kelihatan dengan suara yang didengar.

Pertuturan, bunyi dan pemasaan syot

H3 memodelkan dialog, bunyi fizikal, suasana dan muzik bersama-sama. Kad model mendokumentasikan sokongan dialog stabil untuk bahasa Arab, Cina, Inggeris, Perancis, Jerman, Itali, Jepun, Korea, Portugis, Rusia dan Sepanyol; bahasa lain diterangkan sebagai mempunyai sokongan yang berbeza-beza. Sediakan perkataan pertuturan tepat dan bahasa, dengan identiti penutur stabil merentas syot.

Panduan penulisan prompt pembuat menggunakan bahasa Inggeris untuk bahagian deskriptif sambil mengekalkan dialog dan teks yang kelihatan dalam bahasa asalnya. Kandungan pertuturan menggunakan <d>[Language] ...</d>, dengan identiti penutur dan penerangan suara di luar blok. Bezakan pertuturan fizikal daripada suara latar di luar skrin, dan kenal pasti apabila baris berterusan merentas potongan atau terhenti pada penghujung. Kekalkan teks yang kelihatan dengan tepat juga. Padankan jumlah pertuturan dengan tempoh terpilih dan periksa perkataan yang dirender serta baris yang didengar bersama-sama.

Terangkan gerak kamera sebagai tindakan, termasuk julat dan kelajuannya apabila penting. Nomborkan syot mengikut susunan main balik dan pastikan masa potongan dalam tempoh video. Asingkan bunyi adegan seperti langkah kaki atau pintu menutup daripada skor latar yang hanya didengar khalayak. Pilihan ini menjadikan rancangan syot pendek lebih mudah ditafsir dan lebih mudah disemak terhadap hasilnya.

Persediaan input dan had angka

Skema penjanaan semasa memerlukan teks tidak kosong dalam setiap mod, dengan sehingga 7,000 aksara setiap item teks. Imej boleh berupa JPG, JPEG, PNG, WebP, HEIC atau HEIF, sehingga 30 MB setiap satu, dengan setiap sisi daripada 256 hingga 5,760 piksel dan nisbah aspek daripada 0.4 hingga 2.5. Input bingkai membenarkan satu imej pembukaan dan satu imej penutup; mod rujukan membenarkan sehingga sembilan imej rujukan.

Video rujukan boleh mengandungi sehingga tiga klip MP4 atau MOV, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Klip boleh mencapai 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi daripada 256 hingga 5,760 piksel, nisbah daripada 0.4 hingga 2.5 dan kadar bingkai daripada 23.976 hingga 60. Audio rujukan menyokong sehingga tiga klip WAV atau MP3, sehingga 15 MB setiap satu, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Kad model mengehadkan input rujukan campuran kepada 12 fail. Had badan permintaan yang didokumentasikan ialah 64 MB, berbeza daripada had setiap fail.

Pilih hanya rujukan yang menyumbang kepada taklimat dan jelaskan setiap sumbangan. Pandangan subjek yang jelas lebih berguna daripada beberapa pandangan bercanggah tanpa penerangan. Kekalkan susunan rujukan, pangkas bahan tidak berkaitan tanpa membuang konteks adegan yang diperlukan dan periksa bahawa klip sumber pendek mengandungi tindakan atau ciri suara yang diminta.

Bentuk output dan sistem lengkap

Antara muka H3 pengeluar menawarkan 768P dan 2K. Penjanaan teks sahaja memerlukan nisbah tertentu: 21:9, 16:9, 4:3, 1:1, 3:4 atau 9:16. Penciptaan bingkai pertama/terakhir mengambil nisbah aspeknya daripada imej input; penciptaan rujukan boleh menggunakan nisbah adaptif atau yang dinyatakan. Tempoh output integer ialah 4–15 saat.

Kad model membezakan H3-Context-IR, yang mentafsir dan memperkaya taklimat, H3-Base, yang menjana kandungan audiovisual, dan H3-Regenerate-2K, yang mencipta hasil resolusi lebih tinggi. Titik semak asas yang dikeluarkan mengasingkan tugas berpandukan bingkai dan omni-reference. Komponen konteks dan penjanaan semula berbeza daripada pemberat asas itu, maka nama titik semak terbuka sahaja tidak membuktikan tingkah laku seluruh sistem.

Aliran kerja penjanaan pembuat adalah tak segerak. Antara muka pertanyaan tugasnya mendapatkan tugas daripada tujuh hari sebelumnya. Simpan identiti tugas sehingga hasil video sebenar dipulangkan, kemudian simpan klip, bukannya mengekalkan alamat muat turun terhad masa sahaja. Semak identiti visual, teks kecil, interaksi objek, kandungan pertuturan dan pemasaan bunyi pada saiz tontonan yang dimaksudkan. Pengeluar mengenal pasti pemahaman multimodal dan butiran visual halus sebagai bidang penambahbaikan berterusan; taklimat terperinci dan perbandingan sumber kekal penting untuk hasil yang berguna.

", "aboutText": "Satu hasil audiovisual daripada taklimat multimodal\n\nMiniMax H3 ialah sistem video omni-modal MiniMax. Ia mentafsir teks, imej, video dan audio bersama-sama, kemudian menjana video dengan bunyi stereo natif. Pembuat mempersembahkannya untuk kerja kreatif pendek seperti visual produk, pengiklanan, poster beranimasi dan konsep tajuk filem, apabila hubungan antara aset rujukan sama penting dengan penerangan adegan.\n\nSistem yang didokumentasikan menghasilkan video 4–15 saat pada 24 bingkai sesaat dengan audio stereo 32 kHz. Penjanaan H3-Base beroperasi pada 768p; aliran kerja penuh 2K menjana semula hasil itu menggunakan konteks multimodal asal. Ini lebih daripada ubah saiz lazim: peringkat kedua menggunakan semula model dan konteks sumber untuk memulihkan butiran halus. H3 Max dan H3-Context-IR mempunyai peranan serta had berasingan.\n\nPenciptaan berpandukan teks dan bingkai\n\nInput teks sahaja menerangkan seluruh garis masa audiovisual. Imej pertama menetapkan pembukaan, imej terakhir menetapkan penutup, dan dua imej boleh menentukan kedua-duanya. Untuk syot bingkai pertama, mulakan dengan komposisi dan identiti yang kelihatan dalam imej pegun, kemudian terangkan tindakan yang berkembang daripadanya. Untuk peralihan bingkai pertama ke terakhir, terangkan pergerakan yang dapat diperhatikan yang menghubungkan dua keadaan, bukannya mengulang dua penerangan imej yang tidak berkaitan.\n\nTaklimat produk praktikal boleh menetapkan bungkusan tertutup dalam bingkai pembukaan, tangan yang membukanya, gerakan kamera lembut dan keadaan akhir yang perlu dicapai. Kekalkan bentuk objek, peletakan label dan pencahayaan dalam bingkai yang dibekalkan. Penciptaan berpandukan bingkai dan penciptaan berpandukan rujukan ialah mod input berasingan; antara muka pembuat tidak mencampurkan peranan bingkai pertama/terakhir dengan peranan media rujukan dalam satu permintaan.\n\nPenjanaan dan penyuntingan berpandukan rujukan\n\nMod rujukan menerima teks bersama imej, klip video dan klip audio. Kenal pasti sumbangan setiap sumber: rupa watak, lokasi, gerak kamera, struktur masa klip sumber atau suara. Video yang digunakan hanya untuk gerak kamera berbeza daripada video yang benar-benar patut disunting atau disambung. Nyatakan hubungan itu secara jelas.\n\nPanduan rujukan pembuat mengasingkan takrif subjek, ringkasan tugas, analisis pengekalan, penerangan syot terperinci, landskap bunyi keseluruhan dan muzik latar yang hanya didengar khalayak. Ia membezakan pengekalan kandungan yang kelihatan daripada pemindahan atribut atau rujukan gaya luas. Untuk audio, menyalin isyarat berbeza daripada merujuk timbre, ritma atau penyampaian. Kekalkan kestabilan peranan itu sepanjang taklimat.\n\nUntuk adegan berpandukan rujukan, bekalkan imej watak, rujukan gerak kamera pendek dan rujukan suara audio, kemudian terangkan tempat setiap satu patut mempengaruhi syot sasaran. Nyatakan butiran pakaian, persekitaran atau objek yang mesti kekal dapat dikenali. Bandingkan klip siap dengan keperluan itu, termasuk kesinambungan gerakan dan hubungan antara penutur yang kelihatan dengan suara yang didengar.\n\nPertuturan, bunyi dan pemasaan syot\n\nH3 memodelkan dialog, bunyi fizikal, suasana dan muzik bersama-sama. Kad model mendokumentasikan sokongan dialog stabil untuk bahasa Arab, Cina, Inggeris, Perancis, Jerman, Itali, Jepun, Korea, Portugis, Rusia dan Sepanyol; bahasa lain diterangkan sebagai mempunyai sokongan yang berbeza-beza. Sediakan perkataan pertuturan tepat dan bahasa, dengan identiti penutur stabil merentas syot.\n\nPanduan penulisan prompt pembuat menggunakan bahasa Inggeris untuk bahagian deskriptif sambil mengekalkan dialog dan teks yang kelihatan dalam bahasa asalnya. Kandungan pertuturan menggunakan `[Language] ...`, dengan identiti penutur dan penerangan suara di luar blok. Bezakan pertuturan fizikal daripada suara latar di luar skrin, dan kenal pasti apabila baris berterusan merentas potongan atau terhenti pada penghujung. Kekalkan teks yang kelihatan dengan tepat juga. Padankan jumlah pertuturan dengan tempoh terpilih dan periksa perkataan yang dirender serta baris yang didengar bersama-sama.\n\nTerangkan gerak kamera sebagai tindakan, termasuk julat dan kelajuannya apabila penting. Nomborkan syot mengikut susunan main balik dan pastikan masa potongan dalam tempoh video. Asingkan bunyi adegan seperti langkah kaki atau pintu menutup daripada skor latar yang hanya didengar khalayak. Pilihan ini menjadikan rancangan syot pendek lebih mudah ditafsir dan lebih mudah disemak terhadap hasilnya.\n\nPersediaan input dan had angka\n\nSkema penjanaan semasa memerlukan teks tidak kosong dalam setiap mod, dengan sehingga 7,000 aksara setiap item teks. Imej boleh berupa JPG, JPEG, PNG, WebP, HEIC atau HEIF, sehingga 30 MB setiap satu, dengan setiap sisi daripada 256 hingga 5,760 piksel dan nisbah aspek daripada 0.4 hingga 2.5. Input bingkai membenarkan satu imej pembukaan dan satu imej penutup; mod rujukan membenarkan sehingga sembilan imej rujukan.\n\nVideo rujukan boleh mengandungi sehingga tiga klip MP4 atau MOV, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Klip boleh mencapai 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi daripada 256 hingga 5,760 piksel, nisbah daripada 0.4 hingga 2.5 dan kadar bingkai daripada 23.976 hingga 60. Audio rujukan menyokong sehingga tiga klip WAV atau MP3, sehingga 15 MB setiap satu, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Kad model mengehadkan input rujukan campuran kepada 12 fail. Had badan permintaan yang didokumentasikan ialah 64 MB, berbeza daripada had setiap fail.\n\nPilih hanya rujukan yang menyumbang kepada taklimat dan jelaskan setiap sumbangan. Pandangan subjek yang jelas lebih berguna daripada beberapa pandangan bercanggah tanpa penerangan. Kekalkan susunan rujukan, pangkas bahan tidak berkaitan tanpa membuang konteks adegan yang diperlukan dan periksa bahawa klip sumber pendek mengandungi tindakan atau ciri suara yang diminta.\n\nBentuk output dan sistem lengkap\n\nAntara muka H3 pengeluar menawarkan 768P dan 2K. Penjanaan teks sahaja memerlukan nisbah tertentu: 21:9, 16:9, 4:3, 1:1, 3:4 atau 9:16. Penciptaan bingkai pertama/terakhir mengambil nisbah aspeknya daripada imej input; penciptaan rujukan boleh menggunakan nisbah adaptif atau yang dinyatakan. Tempoh output integer ialah 4–15 saat.\n\nKad model membezakan H3-Context-IR, yang mentafsir dan memperkaya taklimat, H3-Base, yang menjana kandungan audiovisual, dan H3-Regenerate-2K, yang mencipta hasil resolusi lebih tinggi. Titik semak asas yang dikeluarkan mengasingkan tugas berpandukan bingkai dan omni-reference. Komponen konteks dan penjanaan semula berbeza daripada pemberat asas itu, maka nama titik semak terbuka sahaja tidak membuktikan tingkah laku seluruh sistem.\n\nAliran kerja penjanaan pembuat adalah tak segerak. Antara muka pertanyaan tugasnya mendapatkan tugas daripada tujuh hari sebelumnya. Simpan identiti tugas sehingga hasil video sebenar dipulangkan, kemudian simpan klip, bukannya mengekalkan alamat muat turun terhad masa sahaja. Semak identiti visual, teks kecil, interaksi objek, kandungan pertuturan dan pemasaan bunyi pada saiz tontonan yang dimaksudkan. Pengeluar mengenal pasti pemahaman multimodal dan butiran visual halus sebagai bidang penambahbaikan berterusan; taklimat terperinci dan perbandingan sumber kekal penting untuk hasil yang berguna.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8dced9416b5d2075d1084244bd33c9f3f445664572b2a1928c2a2a667aeaff07", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "
MM

MiniMax: H3

MiniMax /minimax/hailuo-3

Pengenalan

MiniMax H3 menjana video pendek dengan audio stereo natif daripada teks, imej bingkai atau rujukan multimodal. Ia menyokong penciptaan bingkai pertama/terakhir, penyuntingan berpandukan rujukan serta hubungan gerakan atau suara, dengan output 4–15 saat dan aliran kerja penjanaan semula 2K yang berbeza.

Input yang diterima
Teks · Imej · Audio · Video
Hasil
Video
Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Satu hasil audiovisual daripada taklimat multimodal

MiniMax H3 ialah sistem video omni-modal MiniMax. Ia mentafsir teks, imej, video dan audio bersama-sama, kemudian menjana video dengan bunyi stereo natif. Pembuat mempersembahkannya untuk kerja kreatif pendek seperti visual produk, pengiklanan, poster beranimasi dan konsep tajuk filem, apabila hubungan antara aset rujukan sama penting dengan penerangan adegan.

Sistem yang didokumentasikan menghasilkan video 4–15 saat pada 24 bingkai sesaat dengan audio stereo 32 kHz. Penjanaan H3-Base beroperasi pada 768p; aliran kerja penuh 2K menjana semula hasil itu menggunakan konteks multimodal asal. Ini lebih daripada ubah saiz lazim: peringkat kedua menggunakan semula model dan konteks sumber untuk memulihkan butiran halus. H3 Max dan H3-Context-IR mempunyai peranan serta had berasingan.

Penciptaan berpandukan teks dan bingkai

Input teks sahaja menerangkan seluruh garis masa audiovisual. Imej pertama menetapkan pembukaan, imej terakhir menetapkan penutup, dan dua imej boleh menentukan kedua-duanya. Untuk syot bingkai pertama, mulakan dengan komposisi dan identiti yang kelihatan dalam imej pegun, kemudian terangkan tindakan yang berkembang daripadanya. Untuk peralihan bingkai pertama ke terakhir, terangkan pergerakan yang dapat diperhatikan yang menghubungkan dua keadaan, bukannya mengulang dua penerangan imej yang tidak berkaitan.

Taklimat produk praktikal boleh menetapkan bungkusan tertutup dalam bingkai pembukaan, tangan yang membukanya, gerakan kamera lembut dan keadaan akhir yang perlu dicapai. Kekalkan bentuk objek, peletakan label dan pencahayaan dalam bingkai yang dibekalkan. Penciptaan berpandukan bingkai dan penciptaan berpandukan rujukan ialah mod input berasingan; antara muka pembuat tidak mencampurkan peranan bingkai pertama/terakhir dengan peranan media rujukan dalam satu permintaan.

Penjanaan dan penyuntingan berpandukan rujukan

Mod rujukan menerima teks bersama imej, klip video dan klip audio. Kenal pasti sumbangan setiap sumber: rupa watak, lokasi, gerak kamera, struktur masa klip sumber atau suara. Video yang digunakan hanya untuk gerak kamera berbeza daripada video yang benar-benar patut disunting atau disambung. Nyatakan hubungan itu secara jelas.

Panduan rujukan pembuat mengasingkan takrif subjek, ringkasan tugas, analisis pengekalan, penerangan syot terperinci, landskap bunyi keseluruhan dan muzik latar yang hanya didengar khalayak. Ia membezakan pengekalan kandungan yang kelihatan daripada pemindahan atribut atau rujukan gaya luas. Untuk audio, menyalin isyarat berbeza daripada merujuk timbre, ritma atau penyampaian. Kekalkan kestabilan peranan itu sepanjang taklimat.

Untuk adegan berpandukan rujukan, bekalkan imej watak, rujukan gerak kamera pendek dan rujukan suara audio, kemudian terangkan tempat setiap satu patut mempengaruhi syot sasaran. Nyatakan butiran pakaian, persekitaran atau objek yang mesti kekal dapat dikenali. Bandingkan klip siap dengan keperluan itu, termasuk kesinambungan gerakan dan hubungan antara penutur yang kelihatan dengan suara yang didengar.

Pertuturan, bunyi dan pemasaan syot

H3 memodelkan dialog, bunyi fizikal, suasana dan muzik bersama-sama. Kad model mendokumentasikan sokongan dialog stabil untuk bahasa Arab, Cina, Inggeris, Perancis, Jerman, Itali, Jepun, Korea, Portugis, Rusia dan Sepanyol; bahasa lain diterangkan sebagai mempunyai sokongan yang berbeza-beza. Sediakan perkataan pertuturan tepat dan bahasa, dengan identiti penutur stabil merentas syot.

Panduan penulisan prompt pembuat menggunakan bahasa Inggeris untuk bahagian deskriptif sambil mengekalkan dialog dan teks yang kelihatan dalam bahasa asalnya. Kandungan pertuturan menggunakan <d>[Language] ...</d>, dengan identiti penutur dan penerangan suara di luar blok. Bezakan pertuturan fizikal daripada suara latar di luar skrin, dan kenal pasti apabila baris berterusan merentas potongan atau terhenti pada penghujung. Kekalkan teks yang kelihatan dengan tepat juga. Padankan jumlah pertuturan dengan tempoh terpilih dan periksa perkataan yang dirender serta baris yang didengar bersama-sama.

Terangkan gerak kamera sebagai tindakan, termasuk julat dan kelajuannya apabila penting. Nomborkan syot mengikut susunan main balik dan pastikan masa potongan dalam tempoh video. Asingkan bunyi adegan seperti langkah kaki atau pintu menutup daripada skor latar yang hanya didengar khalayak. Pilihan ini menjadikan rancangan syot pendek lebih mudah ditafsir dan lebih mudah disemak terhadap hasilnya.

Persediaan input dan had angka

Skema penjanaan semasa memerlukan teks tidak kosong dalam setiap mod, dengan sehingga 7,000 aksara setiap item teks. Imej boleh berupa JPG, JPEG, PNG, WebP, HEIC atau HEIF, sehingga 30 MB setiap satu, dengan setiap sisi daripada 256 hingga 5,760 piksel dan nisbah aspek daripada 0.4 hingga 2.5. Input bingkai membenarkan satu imej pembukaan dan satu imej penutup; mod rujukan membenarkan sehingga sembilan imej rujukan.

Video rujukan boleh mengandungi sehingga tiga klip MP4 atau MOV, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Klip boleh mencapai 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi daripada 256 hingga 5,760 piksel, nisbah daripada 0.4 hingga 2.5 dan kadar bingkai daripada 23.976 hingga 60. Audio rujukan menyokong sehingga tiga klip WAV atau MP3, sehingga 15 MB setiap satu, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Kad model mengehadkan input rujukan campuran kepada 12 fail. Had badan permintaan yang didokumentasikan ialah 64 MB, berbeza daripada had setiap fail.

Pilih hanya rujukan yang menyumbang kepada taklimat dan jelaskan setiap sumbangan. Pandangan subjek yang jelas lebih berguna daripada beberapa pandangan bercanggah tanpa penerangan. Kekalkan susunan rujukan, pangkas bahan tidak berkaitan tanpa membuang konteks adegan yang diperlukan dan periksa bahawa klip sumber pendek mengandungi tindakan atau ciri suara yang diminta.

Bentuk output dan sistem lengkap

Antara muka H3 pengeluar menawarkan 768P dan 2K. Penjanaan teks sahaja memerlukan nisbah tertentu: 21:9, 16:9, 4:3, 1:1, 3:4 atau 9:16. Penciptaan bingkai pertama/terakhir mengambil nisbah aspeknya daripada imej input; penciptaan rujukan boleh menggunakan nisbah adaptif atau yang dinyatakan. Tempoh output integer ialah 4–15 saat.

Kad model membezakan H3-Context-IR, yang mentafsir dan memperkaya taklimat, H3-Base, yang menjana kandungan audiovisual, dan H3-Regenerate-2K, yang mencipta hasil resolusi lebih tinggi. Titik semak asas yang dikeluarkan mengasingkan tugas berpandukan bingkai dan omni-reference. Komponen konteks dan penjanaan semula berbeza daripada pemberat asas itu, maka nama titik semak terbuka sahaja tidak membuktikan tingkah laku seluruh sistem.

Aliran kerja penjanaan pembuat adalah tak segerak. Antara muka pertanyaan tugasnya mendapatkan tugas daripada tujuh hari sebelumnya. Simpan identiti tugas sehingga hasil video sebenar dipulangkan, kemudian simpan klip, bukannya mengekalkan alamat muat turun terhad masa sahaja. Semak identiti visual, teks kecil, interaksi objek, kandungan pertuturan dan pemasaan bunyi pada saiz tontonan yang dimaksudkan. Pengeluar mengenal pasti pemahaman multimodal dan butiran visual halus sebagai bidang penambahbaikan berterusan; taklimat terperinci dan perbandingan sumber kekal penting untuk hasil yang berguna.

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Video POST /v1/videos
Input
text, image, audio, video
Output
video
Format output
bait MP4 asal; tanpa penormalan atau pengekodan semula
MedanJenisKeperluanNilai & hadLalai
MedanmodelJenisstringKeperluanDiperlukanNilai & had
minimax/hailuo-3
Lalai—
MedanpromptJenisstringKeperluanDiperlukanNilai & hadLalai—
MedandurationJenisintegerKeperluanDiperlukanNilai & had
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maksimum: 600
Lalai—
MedanresolutionJenisstringKeperluanPilihanNilai & had
2K
Lalai—
Medanaspect_ratioJenisstringKeperluanPilihanNilai & had
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Lalai—
Medangenerate_audioJenisbooleanKeperluanPilihanNilai & had
false, true
Lalai—
Medanframe_imagesJenisarrayKeperluanPilihanNilai & had
Item minimum: 1
Item maksimum: 2
Kandungan input: Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame atau last_frame. Setiap peranan bingkai boleh muncul paling banyak sekali.
Kunci tepat: type, image_url, frame_type
Syarat: Kunci ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja.
Lalai—
Medaninput_referencesJenisarrayKeperluanPilihanNilai & hadLalai—
Medancallback_urlJenisstringKeperluanPilihanNilai & had
Corak: ^https://
Lalai—
Medansession_idJenisstringKeperluanPilihanNilai & hadLalai—
MedantraceJenisobjectKeperluanPilihanNilai & hadLalai—
MedanuserJenisstringKeperluanPilihanNilai & hadLalai—
Gabungan bahan input

Teks kepada video · Prompt bertulis. · Diperlukan: model, prompt, duration

Berikan prompt sebagai teks dan tempoh dalam saat bulat. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.

model: Jenis: string · minimax/hailuo-3

prompt: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya

Imej kepada video · Prompt bertulis dan imej bingkai pertama. · Diperlukan: model, prompt, duration, frame_images

frame_images ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame dengan last_frame pilihan. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Gunakan imej bingkai atau rujukan imej dalam satu permintaan; jangan gabungkan kedua-duanya. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.

Kunci tepat: type, image_url, frame_type

model: Jenis: string · minimax/hailuo-3

prompt: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya

Reference to video · Prompt bertulis dan rujukan imej, video serta audio yang disokong. · Diperlukan: model, prompt, duration, input_references

input_references ialah tatasusunan objek. Tetapkan type kepada image_url, video_url, audio_url dan gunakan medan sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Anggaran merangkumi komponen setiap imej yang dipaparkan hanya bagi rujukan imej selepas lima imej pertama. Caj akhir mengikut konfigurasi sebenar yang dibilkan. Jangan gabungkan rujukan imej dengan imej bingkai. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.

model: Jenis: string · minimax/hailuo-3

prompt: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya

Parameter kaedah dan kitar hayat
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

Kitar hayat: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Pelan harga

Cara caj akhir dikira

Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas
Tidak dinyatakan Apabila mod pantas dipilih
Mod flex
Tidak dinyatakan Apabila mod flex dipilih
Usaha penaakulan maksimum
Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

KonfigurasiJadual kadarKuantiti ramalanUnit pengebilanSyarat pengebilanCaj
KonfigurasiKadar asas tokenJadual kadarKadar asasKuantiti ramalan—Unit pengebilan—Syarat pengebilan—Caj
Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token
Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token
Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token
Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token
Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token
KonfigurasiHarga videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap saat videoSyarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini.Caj
Output · Harga video · Anggaran untuk perbandingan sahaja $0.26 bagi setiap saat video
Konfigurasiimej rujukanJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap imej rujukanSyarat pengebilan—Caj
Input · imej rujukan · Anggaran untuk perbandingan sahaja $0.08 bagi setiap imej rujukan
KonfigurasiAnggaran kos penjanaanJadual kadar—Kuantiti ramalananggaran untuk satu penjanaanUnit pengebilan—Syarat pengebilan—Caj
Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $1.3 anggaran sebelum penjanaan

Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →

Butiran tarif rujukan

Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.

Rujukan harga konfigurasi video

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

KonfigurasiSyarat pengebilanCaj
KonfigurasiHarga videoSyarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini.Caj
Output · Harga video $0.26 bagi setiap saat video

Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.

KonfigurasiImej rujukan selepas lima imej pertamaSyarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini.Caj
Input · Imej rujukan selepas lima yang pertama $0.08 bagi setiap imej

Lima imej rujukan pertama adalah percuma; kadar setiap imej yang disenaraikan digunakan selepas lima imej pertama. Rujukan harga yang diterbitkan adalah untuk konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.

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

pautan kandungan bertandatangan milik anda

Semak 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 kandungan 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 fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.

Simpan setiap output sebenar milik anda berserta metadata ukuran yang dikembalikan.

Jika respons asal perlu disemak

503 result_pending_check + id asal + X-Should-Retry:false; jangan sekali-kali ulang operasi asal

Medan respons
MedanJenisMaksud
MedanindexJenisintegerMaksudKedudukan video ini dalam senarai output dengan indeks bermula dari sifar.
Medancontent_urlJenisstringMaksudURL muat turun HTTPS bertandatangan untuk video siap ini.
Medansha256Jenisstring | nullMaksudRingkasan SHA-256 bagi bait video asal; null jika tidak tersedia.
Medansize_bytesJenisinteger | nullMaksudSaiz fail video asal dalam bait; null jika tidak tersedia.
Medanduration_msJenisinteger | nullMaksudTempoh video yang diukur dalam milisaat; null jika tidak tersedia.
MedanwidthJenisinteger | nullMaksudLebar video dalam piksel; null jika tidak tersedia.
MedanheightJenisinteger | nullMaksudKetinggian video dalam piksel; null jika tidak tersedia.
Medanvideo_codecJenisstring | nullMaksudPengecam codec video; null jika tidak direkodkan.
Medanhas_audioJenisboolean | nullMaksudSama ada video mengandungi trek audio; null jika tidak diukur.
Medanaudio_codecJenisstring | nullMaksudPengecam codec audio; null apabila tiada pengecam direkodkan.
Ralat dan langkah seterusnya
ResponsSyaratLangkah seterusnya
Respons404 · not_found_errorSyaratAkses video tidak tersedia, atau ID video ini tidak ditemui.Langkah seterusnyaSemak akses video. Untuk video sedia ada, gunakan ID awam asalnya dan kunci API yang sama.
Respons401 · authentication_errorSyaratKunci API tidak sepadan dengan akaun yang disahkan.Langkah seterusnyaSemak kunci API dan akses akaun anda sebelum menghantar.
Respons400 · invalid_request_errorSyaratPermintaan tidak dapat dibaca, atau indeks muat turun tidak sah.Langkah seterusnyaBetulkan badan permintaan. Untuk muat turun, pilih indeks output yang dikembalikan oleh tugas asal.
Respons422 · price_unavailableSyaratHarga konfigurasi video yang dipilih tidak dapat ditentukan.Langkah seterusnyaPilih konfigurasi video yang disokong dan lengkapkan pilihan wajibnya sebelum menghantar permintaan yang dibetulkan.
Respons422 · invalid_request_errorSyaratInput video atau tugas sambungan asal tidak sah.Langkah seterusnyaGunakan input HTTPS yang sah. Untuk sambungan, gunakan ID video awam asal anda yang telah siap dengan kunci API yang sama.
Respons402 · billing_errorSyaratBaki atau had yang tersedia tidak membenarkan penahanan dana.Langkah seterusnyaSemak baki dan had yang tersedia sebelum menghantar permintaan baharu.
Respons503 · server_errorSyaratPengesahan video, storan atau akses perkhidmatan tidak tersedia buat sementara waktu.Langkah seterusnyaTunggu sehingga perkhidmatan tersedia. Jika anda sudah mempunyai ID video, semak tugas asal tersebut dan jangan cipta penjanaan lain.
Respons503 · result_pending_checkSyaratHasil video asal dan caj perlu disemak.Langkah seterusnyaSimpan ID video yang dikembalikan dan semak tugas tersebut. Jangan hantar permintaan penjanaan gantian semasa semakan sedang berjalan.
Respons503 · owned_result_unavailableSyaratMuat turun video sedia ada tidak tersedia buat sementara waktu.Langkah seterusnyaSemak tugas video yang sama kemudian dan muat turun output sedia ada. Penjanaan baharu mencipta operasi berasingan.
Respons409 · video_not_readySyaratKandungan video belum diterbitkan.Langkah seterusnyaSemak status tugas asal. Muat turun selepas statusnya melaporkan completed; jika statusnya melaporkan failed, ikuti notis semakan cajnya.

Alias

Alias model

Ailoot Ultra minimax/hailuo-3

Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

ID pemanggil berkaitan

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": "Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.", "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 output sebenar milik anda berserta metadata ukuran 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 ditemui.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Semak akses video. Untuk video sedia ada, gunakan ID awam asalnya dan kunci API yang sama.", "type": "not_found_error" }, { "condition": "Kunci API tidak sepadan dengan akaun yang disahkan.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Semak kunci API dan akses akaun anda sebelum menghantar.", "type": "authentication_error" }, { "condition": "Permintaan tidak dapat dibaca, atau indeks muat turun tidak sah.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Betulkan badan permintaan. Untuk muat turun, pilih indeks output yang dikembalikan oleh tugas asal.", "type": "invalid_request_error" }, { "condition": "Harga konfigurasi video yang dipilih tidak dapat ditentukan.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Pilih konfigurasi video yang disokong dan lengkapkan pilihan wajibnya sebelum menghantar permintaan yang dibetulkan.", "type": "price_unavailable" }, { "condition": "Input video atau tugas sambungan asal tidak sah.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gunakan input HTTPS yang sah. Untuk sambungan, gunakan ID video awam asal anda yang telah siap dengan kunci API yang sama.", "type": "invalid_request_error" }, { "condition": "Baki atau had yang tersedia tidak membenarkan penahanan dana.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Semak baki dan had yang tersedia sebelum menghantar permintaan baharu.", "type": "billing_error" }, { "condition": "Pengesahan video, storan atau akses perkhidmatan tidak tersedia buat sementara waktu.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Tunggu sehingga perkhidmatan tersedia. Jika anda sudah mempunyai ID video, semak tugas asal tersebut dan jangan cipta penjanaan lain.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Hasil video asal dan caj perlu disemak.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Simpan ID video yang dikembalikan dan semak tugas tersebut. Jangan hantar permintaan penjanaan gantian semasa semakan sedang berjalan.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Muat turun video sedia ada tidak tersedia buat sementara waktu.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Semak tugas video yang sama kemudian dan muat turun output sedia ada. Penjanaan baharu mencipta operasi berasingan.", "type": "server_error" }, { "condition": "Kandungan video belum diterbitkan.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Semak status tugas asal. Muat turun selepas statusnya melaporkan completed; jika statusnya melaporkan failed, ikuti notis semakan cajnya.", "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 asal + X-Should-Retry:false; jangan sekali-kali ulang operasi asal" }, "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 tempoh dalam saat bulat. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt bertulis." }, { "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 ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame dengan last_frame pilihan. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Gunakan imej bingkai atau rujukan imej dalam satu permintaan; jangan gabungkan kedua-duanya. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt bertulis dan imej 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 ialah tatasusunan objek. Tetapkan type kepada image_url, video_url, audio_url dan gunakan medan sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Anggaran merangkumi komponen setiap imej yang dipaparkan hanya bagi rujukan imej selepas lima imej pertama. Caj akhir mengikut konfigurasi sebenar yang dibilkan. Jangan gabungkan rujukan imej dengan imej bingkai. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Prompt bertulis dan rujukan imej, video serta audio yang disokong." } ], "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": "Kedudukan video ini dalam senarai output dengan indeks bermula dari sifar.", "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 muat turun HTTPS bertandatangan untuk video siap 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": "Ringkasan SHA-256 bagi bait video asal; 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": "Saiz fail video asal dalam bait; 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": "Tempoh video yang diukur dalam milisaat; 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": "Ketinggian 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": "Pengecam codec video; null jika tidak direkodkan.", "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": "Sama ada video mengandungi 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": "Pengecam codec audio; null apabila tiada pengecam direkodkan.", "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": "pautan kandungan bertandatangan milik anda", "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 ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja.", "content": "Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame atau last_frame. Setiap peranan bingkai boleh 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": "Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Anggaran kos penjanaan", "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": "bf817d5cb147d2e255abbecd5f109ec1a642353df3602e1d3e1175c40dcb513f", "input_html_sha256": "d805324ad0e4c3b1cf13b10e23387d5f021965013326486ad502b1bf7ff8b20f", "private_audit_sha256": "b0d9fe70f31bb98e0857b189235a784a5d1a284828833ca4acd3296ee073f774", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ms/minimax-hailuo-3/", "description": "MiniMax H3 menjana video pendek dengan audio stereo natif daripada teks, imej bingkai atau rujukan multimodal. Ia menyokong penciptaan bingkai pertama/terakhir, penyuntingan berpandukan rujukan serta hubungan gerakan atau suara, dengan output 4–15 saat dan aliran kerja penjanaan semula 2K yang berbeza.", "locale": "ms", "md_url": "https://ailoot.ai/models/ms/minimax-hailuo-3/index.md", "title": "MiniMax: H3 — Ailoot", "url": "https://ailoot.ai/models/ms/minimax-hailuo-3/" }, "rawModel": { "about": "Satu hasil audiovisual daripada taklimat multimodal\n\nMiniMax H3 ialah sistem video omni-modal MiniMax. Ia mentafsir teks, imej, video dan audio bersama-sama, kemudian menjana video dengan bunyi stereo natif. Pembuat mempersembahkannya untuk kerja kreatif pendek seperti visual produk, pengiklanan, poster beranimasi dan konsep tajuk filem, apabila hubungan antara aset rujukan sama penting dengan penerangan adegan.\n\nSistem yang didokumentasikan menghasilkan video 4–15 saat pada 24 bingkai sesaat dengan audio stereo 32 kHz. Penjanaan H3-Base beroperasi pada 768p; aliran kerja penuh 2K menjana semula hasil itu menggunakan konteks multimodal asal. Ini lebih daripada ubah saiz lazim: peringkat kedua menggunakan semula model dan konteks sumber untuk memulihkan butiran halus. H3 Max dan H3-Context-IR mempunyai peranan serta had berasingan.\n\nPenciptaan berpandukan teks dan bingkai\n\nInput teks sahaja menerangkan seluruh garis masa audiovisual. Imej pertama menetapkan pembukaan, imej terakhir menetapkan penutup, dan dua imej boleh menentukan kedua-duanya. Untuk syot bingkai pertama, mulakan dengan komposisi dan identiti yang kelihatan dalam imej pegun, kemudian terangkan tindakan yang berkembang daripadanya. Untuk peralihan bingkai pertama ke terakhir, terangkan pergerakan yang dapat diperhatikan yang menghubungkan dua keadaan, bukannya mengulang dua penerangan imej yang tidak berkaitan.\n\nTaklimat produk praktikal boleh menetapkan bungkusan tertutup dalam bingkai pembukaan, tangan yang membukanya, gerakan kamera lembut dan keadaan akhir yang perlu dicapai. Kekalkan bentuk objek, peletakan label dan pencahayaan dalam bingkai yang dibekalkan. Penciptaan berpandukan bingkai dan penciptaan berpandukan rujukan ialah mod input berasingan; antara muka pembuat tidak mencampurkan peranan bingkai pertama/terakhir dengan peranan media rujukan dalam satu permintaan.\n\nPenjanaan dan penyuntingan berpandukan rujukan\n\nMod rujukan menerima teks bersama imej, klip video dan klip audio. Kenal pasti sumbangan setiap sumber: rupa watak, lokasi, gerak kamera, struktur masa klip sumber atau suara. Video yang digunakan hanya untuk gerak kamera berbeza daripada video yang benar-benar patut disunting atau disambung. Nyatakan hubungan itu secara jelas.\n\nPanduan rujukan pembuat mengasingkan takrif subjek, ringkasan tugas, analisis pengekalan, penerangan syot terperinci, landskap bunyi keseluruhan dan muzik latar yang hanya didengar khalayak. Ia membezakan pengekalan kandungan yang kelihatan daripada pemindahan atribut atau rujukan gaya luas. Untuk audio, menyalin isyarat berbeza daripada merujuk timbre, ritma atau penyampaian. Kekalkan kestabilan peranan itu sepanjang taklimat.\n\nUntuk adegan berpandukan rujukan, bekalkan imej watak, rujukan gerak kamera pendek dan rujukan suara audio, kemudian terangkan tempat setiap satu patut mempengaruhi syot sasaran. Nyatakan butiran pakaian, persekitaran atau objek yang mesti kekal dapat dikenali. Bandingkan klip siap dengan keperluan itu, termasuk kesinambungan gerakan dan hubungan antara penutur yang kelihatan dengan suara yang didengar.\n\nPertuturan, bunyi dan pemasaan syot\n\nH3 memodelkan dialog, bunyi fizikal, suasana dan muzik bersama-sama. Kad model mendokumentasikan sokongan dialog stabil untuk bahasa Arab, Cina, Inggeris, Perancis, Jerman, Itali, Jepun, Korea, Portugis, Rusia dan Sepanyol; bahasa lain diterangkan sebagai mempunyai sokongan yang berbeza-beza. Sediakan perkataan pertuturan tepat dan bahasa, dengan identiti penutur stabil merentas syot.\n\nPanduan penulisan prompt pembuat menggunakan bahasa Inggeris untuk bahagian deskriptif sambil mengekalkan dialog dan teks yang kelihatan dalam bahasa asalnya. Kandungan pertuturan menggunakan `[Language] ...`, dengan identiti penutur dan penerangan suara di luar blok. Bezakan pertuturan fizikal daripada suara latar di luar skrin, dan kenal pasti apabila baris berterusan merentas potongan atau terhenti pada penghujung. Kekalkan teks yang kelihatan dengan tepat juga. Padankan jumlah pertuturan dengan tempoh terpilih dan periksa perkataan yang dirender serta baris yang didengar bersama-sama.\n\nTerangkan gerak kamera sebagai tindakan, termasuk julat dan kelajuannya apabila penting. Nomborkan syot mengikut susunan main balik dan pastikan masa potongan dalam tempoh video. Asingkan bunyi adegan seperti langkah kaki atau pintu menutup daripada skor latar yang hanya didengar khalayak. Pilihan ini menjadikan rancangan syot pendek lebih mudah ditafsir dan lebih mudah disemak terhadap hasilnya.\n\nPersediaan input dan had angka\n\nSkema penjanaan semasa memerlukan teks tidak kosong dalam setiap mod, dengan sehingga 7,000 aksara setiap item teks. Imej boleh berupa JPG, JPEG, PNG, WebP, HEIC atau HEIF, sehingga 30 MB setiap satu, dengan setiap sisi daripada 256 hingga 5,760 piksel dan nisbah aspek daripada 0.4 hingga 2.5. Input bingkai membenarkan satu imej pembukaan dan satu imej penutup; mod rujukan membenarkan sehingga sembilan imej rujukan.\n\nVideo rujukan boleh mengandungi sehingga tiga klip MP4 atau MOV, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Klip boleh mencapai 50 MB; codec videonya H.264 atau H.265, dengan audio AAC atau MP3, sisi daripada 256 hingga 5,760 piksel, nisbah daripada 0.4 hingga 2.5 dan kadar bingkai daripada 23.976 hingga 60. Audio rujukan menyokong sehingga tiga klip WAV atau MP3, sehingga 15 MB setiap satu, setiap satu 2–15 saat dan bersama-sama tidak melebihi 15 saat. Kad model mengehadkan input rujukan campuran kepada 12 fail. Had badan permintaan yang didokumentasikan ialah 64 MB, berbeza daripada had setiap fail.\n\nPilih hanya rujukan yang menyumbang kepada taklimat dan jelaskan setiap sumbangan. Pandangan subjek yang jelas lebih berguna daripada beberapa pandangan bercanggah tanpa penerangan. Kekalkan susunan rujukan, pangkas bahan tidak berkaitan tanpa membuang konteks adegan yang diperlukan dan periksa bahawa klip sumber pendek mengandungi tindakan atau ciri suara yang diminta.\n\nBentuk output dan sistem lengkap\n\nAntara muka H3 pengeluar menawarkan 768P dan 2K. Penjanaan teks sahaja memerlukan nisbah tertentu: 21:9, 16:9, 4:3, 1:1, 3:4 atau 9:16. Penciptaan bingkai pertama/terakhir mengambil nisbah aspeknya daripada imej input; penciptaan rujukan boleh menggunakan nisbah adaptif atau yang dinyatakan. Tempoh output integer ialah 4–15 saat.\n\nKad model membezakan H3-Context-IR, yang mentafsir dan memperkaya taklimat, H3-Base, yang menjana kandungan audiovisual, dan H3-Regenerate-2K, yang mencipta hasil resolusi lebih tinggi. Titik semak asas yang dikeluarkan mengasingkan tugas berpandukan bingkai dan omni-reference. Komponen konteks dan penjanaan semula berbeza daripada pemberat asas itu, maka nama titik semak terbuka sahaja tidak membuktikan tingkah laku seluruh sistem.\n\nAliran kerja penjanaan pembuat adalah tak segerak. Antara muka pertanyaan tugasnya mendapatkan tugas daripada tujuh hari sebelumnya. Simpan identiti tugas sehingga hasil video sebenar dipulangkan, kemudian simpan klip, bukannya mengekalkan alamat muat turun terhad masa sahaja. Semak identiti visual, teks kecil, interaksi objek, kandungan pertuturan dan pemasaan bunyi pada saiz tontonan yang dimaksudkan. Pengeluar mengenal pasti pemahaman multimodal dan butiran visual halus sebagai bidang penambahbaikan berterusan; taklimat terperinci dan perbandingan sumber kekal penting untuk 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": "Maklumat lengkap tentang harga konfigurasi terdapat dalam butiran." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "ffcc346d33bca9e66b22f181", "label": "Rujukan harga konfigurasi video", "profiles": [ { "basis": "Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.", "dimensions": { "conditions": "Tiada syarat tambahan 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 imej rujukan pertama adalah percuma; kadar setiap imej yang disenaraikan digunakan selepas lima imej pertama. Rujukan harga yang diterbitkan adalah untuk konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.", "dimensions": { "conditions": "Tiada syarat tambahan dinyatakan dalam kunci harga ini." }, "label": "Imej rujukan selepas lima imej 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": "Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.", "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 output sebenar milik anda berserta metadata ukuran 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 ditemui.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Semak akses video. Untuk video sedia ada, gunakan ID awam asalnya dan kunci API yang sama.", "type": "not_found_error" }, { "condition": "Kunci API tidak sepadan dengan akaun yang disahkan.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Semak kunci API dan akses akaun anda sebelum menghantar.", "type": "authentication_error" }, { "condition": "Permintaan tidak dapat dibaca, atau indeks muat turun tidak sah.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Betulkan badan permintaan. Untuk muat turun, pilih indeks output yang dikembalikan oleh tugas asal.", "type": "invalid_request_error" }, { "condition": "Harga konfigurasi video yang dipilih tidak dapat ditentukan.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Pilih konfigurasi video yang disokong dan lengkapkan pilihan wajibnya sebelum menghantar permintaan yang dibetulkan.", "type": "price_unavailable" }, { "condition": "Input video atau tugas sambungan asal tidak sah.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Gunakan input HTTPS yang sah. Untuk sambungan, gunakan ID video awam asal anda yang telah siap dengan kunci API yang sama.", "type": "invalid_request_error" }, { "condition": "Baki atau had yang tersedia tidak membenarkan penahanan dana.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Semak baki dan had yang tersedia sebelum menghantar permintaan baharu.", "type": "billing_error" }, { "condition": "Pengesahan video, storan atau akses perkhidmatan tidak tersedia buat sementara waktu.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Tunggu sehingga perkhidmatan tersedia. Jika anda sudah mempunyai ID video, semak tugas asal tersebut dan jangan cipta penjanaan lain.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Hasil video asal dan caj perlu disemak.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Simpan ID video yang dikembalikan dan semak tugas tersebut. Jangan hantar permintaan penjanaan gantian semasa semakan sedang berjalan.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Muat turun video sedia ada tidak tersedia buat sementara waktu.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Semak tugas video yang sama kemudian dan muat turun output sedia ada. Penjanaan baharu mencipta operasi berasingan.", "type": "server_error" }, { "condition": "Kandungan video belum diterbitkan.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Semak status tugas asal. Muat turun selepas statusnya melaporkan completed; jika statusnya melaporkan failed, ikuti notis semakan cajnya.", "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 asal + X-Should-Retry:false; jangan sekali-kali ulang operasi asal" }, "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 tempoh dalam saat bulat. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt bertulis." }, { "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 ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame dengan last_frame pilihan. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Gunakan imej bingkai atau rujukan imej dalam satu permintaan; jangan gabungkan kedua-duanya. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt bertulis dan imej 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 ialah tatasusunan objek. Tetapkan type kepada image_url, video_url, audio_url dan gunakan medan sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Anggaran merangkumi komponen setiap imej yang dipaparkan hanya bagi rujukan imej selepas lima imej pertama. Caj akhir mengikut konfigurasi sebenar yang dibilkan. Jangan gabungkan rujukan imej dengan imej bingkai. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Prompt bertulis dan rujukan imej, video serta audio yang disokong." } ], "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": "Kedudukan video ini dalam senarai output dengan indeks bermula dari sifar.", "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 muat turun HTTPS bertandatangan untuk video siap 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": "Ringkasan SHA-256 bagi bait video asal; 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": "Saiz fail video asal dalam bait; 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": "Tempoh video yang diukur dalam milisaat; 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": "Ketinggian 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": "Pengecam codec video; null jika tidak direkodkan.", "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": "Sama ada video mengandungi 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": "Pengecam codec audio; null apabila tiada pengecam direkodkan.", "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": "pautan kandungan bertandatangan milik anda", "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 ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja.", "content": "Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame atau last_frame. Setiap peranan bingkai boleh 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": "Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Anggaran kos penjanaan", "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 menjana video pendek dengan audio stereo natif daripada teks, imej bingkai atau rujukan multimodal. Ia menyokong penciptaan bingkai pertama/terakhir, penyuntingan berpandukan rujukan serta hubungan gerakan atau suara, dengan output 4–15 saat dan aliran kerja penjanaan semula 2K yang berbeza." }, "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 menjana video pendek dengan audio stereo natif daripada teks, imej bingkai atau rujukan multimodal. Ia menyokong penciptaan bingkai pertama/terakhir, penyuntingan berpandukan rujukan serta hubungan gerakan atau suara, dengan output 4–15 saat dan aliran kerja penjanaan semula 2K yang berbeza.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "6366a68dfb4d6ad1acf1841099008dddb9bdcd64b0146ae5cc31cebbf6e8f75a", "renderer_sha256": "1dab5ba62521e9568c8b7c82005622cabbf330a075df7cce1f83274a04009460" }, "sourceRevision": "fa585f30064ed423027f92c3148ecedee56ff3df1c754dc2ba05ef4167dbd325" }