{ "aboutHtml": "

Seedance 2.0 ialah model standard ByteDance Seed untuk penciptaan audio-video multimodal. Ia menggabungkan teks, imej, video dan audio dalam seni bina penjanaan bersama, dengan aliran kerja kreatif berasingan untuk adegan berpandukan rujukan, penyuntingan video dan pemanjangan video. Ia berguna apabila taklimat memerlukan persembahan koheren serta maklumat visual atau bunyi tertentu daripada bahan yang disediakan.

Rujukan multimodal dan kawalan pengarahan

Imej boleh menentukan rupa subjek, gaya visual dan komposisi. Rujukan video boleh membimbing tindakan, gerak kamera dan kesan. Audio boleh membimbing timbre suara, muzik atau dialog. Tentukan peranan setiap bahan, kemudian terangkan adegan yang patut terhasil. Pengeluar menekankan kawalan persembahan, pencahayaan, bayang-bayang dan bahasa kamera.

Untuk cerita produk, sediakan gambar produk, rujukan gerak kamera dan petunjuk audio. Taklimat boleh berbunyi: “Kekalkan pasu kaca biru daripada Image 1. Gunakan gerakan penjejakan sisi perlahan daripada Video 1. Pasu berada di rak yang disinari matahari, dengan muzik instrumental lembut berasaskan Audio 1.” Output yang dimaksudkan ialah adegan yang dipentaskan semula dan menggabungkan maklumat rujukan terpilih.

Input rujukan boleh menggabungkan imej dengan audio, imej dengan video, video dengan audio atau ketiga-tiganya. Input audio sahaja dan teks bersama audio tanpa imej atau video tidak disokong. Teks-ke-video tradisional, penjanaan bingkai pertama dan penjanaan bingkai pertama serta terakhir turut didokumentasikan. Jika komposisi pembukaan dan penutup tetap penting, gunakan aliran kerja titik akhir khusus: menamakan imej rujukan sebagai titik akhir dalam prompt omni-reference hanyalah cara tidak langsung untuk membimbingnya.

Menyunting rakaman

Model boleh menggantikan subjek, menambah atau membuang objek, mengubah unsur serta melukis semula atau membaiki bahagian video. Terangkan perubahan khusus dan kenal pasti rakaman sumber. Untuk penambahan, sertakan masa kemunculan dan kedudukan; untuk pembuangan atau penggantian, nyatakan objek dengan tepat dan namakan perkara yang patut kekal.

Contohnya: “Gantikan lampu meja dalam Video 1 dengan lampu loyang dalam Image 1. Kekalkan gerak kamera, susunan meja dan arah pencahayaan.” Hasil yang dikehendaki ialah versi suntingan adegan dengan penggantian yang dimaksudkan. Periksa kawasan yang tidak berubah serta objek baharu, khususnya semasa terlindung, bergerak dan bertukar syot.

Memanjangkan dan menghubungkan urutan

Seedance 2.0 boleh memanjangkan video ke hadapan atau ke belakang, serta menghubungkan sehingga tiga klip yang dibekalkan dengan peralihan janaan. Nyatakan arah masa dan peristiwa baharu. Untuk penghubung, susun klip dan terangkan peralihan antara setiap pasangan, seperti kamera memasuki pintu dalam satu syot dan tiba di persekitaran seterusnya.

Pemanjangan mudah biasanya memulangkan sambungan yang dibangunkan di sekitar rakaman sumber; sertakan arahan jelas jika hasil akhir patut mengulang segmen asal juga. Apabila melengkapkan penghubungan antara dua atau tiga klip, aliran kerja yang didokumentasikan boleh merangkumi bahan asal serta kandungan peralihan baharu. Ini berguna untuk mengembangkan pembukaan atau penutup, atau menghubungkan adegan yang disediakan tanpa membiarkan tindakan penyambung tidak ditentukan.

Output edisi standard dan 4K

Edisi standard mendokumentasikan MP4 pada 24 fps dan tempoh daripada 4 hingga 15 saat. Tahap output ialah 480p, 720p dan 1080p dengan kedalaman warna 8-bit, serta 4K dengan kedalaman warna 10-bit. Nisbah yang disokong ialah 21:9, 16:9, 4:3, 1:1, 3:4 dan 9:16. Pembingkaian adaptif dan pemilihan tempoh automatik turut didokumentasikan. Edisi Fast mempunyai spesifikasi output 480p/720p sendiri yang lebih terhad.

Output 4K menggunakan pengekodan H.265/HEVC. Pengekodan sepuluh bit mengekalkan lebih banyak gradasi tona dan peralihan warna lebih licin, yang penting untuk bahan dengan gradien cahaya atau warna halus. Periksa bahawa persekitaran main balik dan penyuntingan sasaran boleh menyahkod format tersebut; sesetengah pelayar dan peranti tidak memainkannya secara terus. Bekas fail yang serasi tidak semestinya memastikan penyahkodan video yang serasi.

Model boleh menjana bunyi terselaras atau video senyap, dan boleh memulangkan bingkai terakhir yang dijana untuk adegan berikutnya. Audio janaan ialah mono. Keluarga 2.0 tidak menyokong mod pratonton Draft dua peringkat yang berasingan, jadi ciri pratonton itu tidak patut disimpulkan daripada edisi Seedance lain.

Persediaan rujukan dan batas penting

Kapasiti rujukan yang didokumentasikan ialah sehingga sembilan imej, tiga video dan tiga klip audio. Muat naik terus imej atau video rujukan yang mengandungi wajah manusia sebenar tidak diterima dalam profil pengeluar yang didokumentasikan ini; kerja potret menggunakan aliran kerja aset potret yang disokongnya. Setiap klip video dan audio mesti sepanjang 2–15 saat. Semua rujukan video bersama mesti muat dalam 15 saat, manakala semua rujukan audio bersama mempunyai jumlah 15 saatnya sendiri. Fail video menggunakan MP4 atau MOV pada 24–60 fps, sehingga 200 MB setiap satu; fail audio menggunakan WAV atau MP3, sehingga 15 MB setiap satu. Format imej yang disenaraikan ialah JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC dan HEIF. Setiap imej mesti lebih kecil daripada 30 MB, dan badan permintaan tidak boleh melebihi 64 MB. Dalam profil input rujukan yang didokumentasikan, lebar dan tinggi imej masing-masing mesti melebihi 300 dan kurang daripada 6,000 piksel, dengan nisbah lebar kepada tinggi melebihi 0.4 dan kurang daripada 2.5. Video rujukan membenarkan 300–6,000 piksel bagi setiap dimensi dan nisbah 0.4–2.5, termasuk nilai sempadan, dengan jumlah 407,696–8,295,044 piksel. Video MP4 atau MOV menggunakan video H.264/AVC atau H.265/HEVC dan audio AAC atau MP3.

Susun fail dengan sengaja dan rujuk setiap satunya melalui jenis media dan nombor: Image 1, Video 1 dan Audio 1. Nombor mengikut susunan antara fail daripada jenis itu. Jelaskan ciri yang perlu dipindahkan dan kandungan sumber yang tidak patut menentukan adegan baharu. Bahasa prompt yang didokumentasikan merangkumi bahasa Inggeris, Sepanyol, Indonesia, Portugis dan Jepun. Kekalkan bahasa pertuturan yang konsisten dalam dialog; panduan menasihatkan supaya tidak mencampurkan bahasa kecuali nama khas. Untuk kerja berpandukan suara, asingkan penutur, baris yang tepat dan arahan penyampaian.

Sediakan imej pertama dan terakhir dengan pembingkaian yang serasi. Ketidakpadanan antara gambar input dengan dimensi output boleh menyebabkan pemangkasan atau perubahan visual mendadak; dimensi sepadan dan pembingkaian adaptif ialah penyelesaian yang didokumentasikan. Tumpukan penerangan pada peristiwa dan peranan rujukan. Pengeluar memberi amaran bahawa prompt panjang boleh menyebarkan maklumat sehingga butiran diabaikan. Semak gerakan yang terhasil, kesinambungan rujukan, persembahan audio dan titik sambungan antara adegan sebagai bahagian berbeza hasil kreatif.

Perancangan syot dan pengarahan teks

Untuk adegan kompleks, susun taklimat sebagai Shot 1, Shot 2 dan Shot 3, dengan menetapkan kamera, tindakan subjek, kedudukan dan bunyi mengikut urutan. Panduan mengesyorkan satu gerak kamera bagi setiap syot dan mengutamakan tindakan perlahan yang bersambung. Cap masa tepat bagi setiap syot tidak stabil, maka urutan peristiwa ialah kawalan yang lebih baik daripada memaksa beberapa tetingkap masa tepat.

Model turut menjana teks lazim, termasuk slogan, sari kata dan gelembung pertuturan. Anda boleh mengarahkan warna, olahan visual, lokasi dan kemunculan teks. Gunakan aksara lazim, bukannya aksara jarang atau simbol khas, dan semak perkataannya semasa bergerak. Untuk rujukan subjek, kaitkan setiap aset dengan jelas kepada watak atau objek yang dimaksudkan. Sudut pandangan produk boleh membekalkan maklumat visual berbeza; kolaj watak dari pelbagai sudut boleh mengelirukan identiti wajah. Potret kepala jelas dan imej seluruh badan yang berasingan ialah cadangan rujukan watak yang didokumentasikan.

Tingkah laku untuk diperiksa sebelum suntingan

Panduan mendokumentasikan sari kata, logo, watak pendua dan penyimpangan gaya yang tidak dikehendaki. Bahan sumber bersih, label konsisten dan kekangan jelas mengurangkan risiko itu, tetapi tidak menjamin teks atau figura pendua yang tidak dikehendaki hilang. Lebih daripada empat orang rujukan dilaporkan sebagai risiko kestabilan, yang berbeza daripada bilangan fail yang diterima model.

Pemanjangan video boleh menghasilkan lompatan atau pengunduran pada titik sambungan, dan sambungan berulang boleh menggandakan kemerosotan kualiti imej. Periksa bingkai sempadan dan hadkan pemanjangan bertindan. Suara rujukan boleh berbeza daripada timbre sumber; narasi mungkin berakhir dengan bunyi klik atau terputus secara mendadak, yang boleh diatasi dengan pemudaran audio seperti didokumentasikan. Aksara Cina polifonik, jarang atau berbentuk serupa boleh disebut secara salah. Untuk kesan animasi tepat, seperti kira detik, rujukan gerakan lebih bermaklumat daripada permintaan lisan sahaja. Ini ialah sebab konkrit untuk memeriksa identiti, teks, gerakan dan bunyi secara berasingan apabila memilih klip.

", "aboutText": "Seedance 2.0 ialah model standard ByteDance Seed untuk penciptaan audio-video multimodal. Ia menggabungkan teks, imej, video dan audio dalam seni bina penjanaan bersama, dengan aliran kerja kreatif berasingan untuk adegan berpandukan rujukan, penyuntingan video dan pemanjangan video. Ia berguna apabila taklimat memerlukan persembahan koheren serta maklumat visual atau bunyi tertentu daripada bahan yang disediakan.\n\n### Rujukan multimodal dan kawalan pengarahan\n\nImej boleh menentukan rupa subjek, gaya visual dan komposisi. Rujukan video boleh membimbing tindakan, gerak kamera dan kesan. Audio boleh membimbing timbre suara, muzik atau dialog. Tentukan peranan setiap bahan, kemudian terangkan adegan yang patut terhasil. Pengeluar menekankan kawalan persembahan, pencahayaan, bayang-bayang dan bahasa kamera.\n\nUntuk cerita produk, sediakan gambar produk, rujukan gerak kamera dan petunjuk audio. Taklimat boleh berbunyi: “Kekalkan pasu kaca biru daripada Image 1. Gunakan gerakan penjejakan sisi perlahan daripada Video 1. Pasu berada di rak yang disinari matahari, dengan muzik instrumental lembut berasaskan Audio 1.” Output yang dimaksudkan ialah adegan yang dipentaskan semula dan menggabungkan maklumat rujukan terpilih.\n\nInput rujukan boleh menggabungkan imej dengan audio, imej dengan video, video dengan audio atau ketiga-tiganya. Input audio sahaja dan teks bersama audio tanpa imej atau video tidak disokong. Teks-ke-video tradisional, penjanaan bingkai pertama dan penjanaan bingkai pertama serta terakhir turut didokumentasikan. Jika komposisi pembukaan dan penutup tetap penting, gunakan aliran kerja titik akhir khusus: menamakan imej rujukan sebagai titik akhir dalam prompt omni-reference hanyalah cara tidak langsung untuk membimbingnya.\n\n### Menyunting rakaman\n\nModel boleh menggantikan subjek, menambah atau membuang objek, mengubah unsur serta melukis semula atau membaiki bahagian video. Terangkan perubahan khusus dan kenal pasti rakaman sumber. Untuk penambahan, sertakan masa kemunculan dan kedudukan; untuk pembuangan atau penggantian, nyatakan objek dengan tepat dan namakan perkara yang patut kekal.\n\nContohnya: “Gantikan lampu meja dalam Video 1 dengan lampu loyang dalam Image 1. Kekalkan gerak kamera, susunan meja dan arah pencahayaan.” Hasil yang dikehendaki ialah versi suntingan adegan dengan penggantian yang dimaksudkan. Periksa kawasan yang tidak berubah serta objek baharu, khususnya semasa terlindung, bergerak dan bertukar syot.\n\n### Memanjangkan dan menghubungkan urutan\n\nSeedance 2.0 boleh memanjangkan video ke hadapan atau ke belakang, serta menghubungkan sehingga tiga klip yang dibekalkan dengan peralihan janaan. Nyatakan arah masa dan peristiwa baharu. Untuk penghubung, susun klip dan terangkan peralihan antara setiap pasangan, seperti kamera memasuki pintu dalam satu syot dan tiba di persekitaran seterusnya.\n\nPemanjangan mudah biasanya memulangkan sambungan yang dibangunkan di sekitar rakaman sumber; sertakan arahan jelas jika hasil akhir patut mengulang segmen asal juga. Apabila melengkapkan penghubungan antara dua atau tiga klip, aliran kerja yang didokumentasikan boleh merangkumi bahan asal serta kandungan peralihan baharu. Ini berguna untuk mengembangkan pembukaan atau penutup, atau menghubungkan adegan yang disediakan tanpa membiarkan tindakan penyambung tidak ditentukan.\n\n### Output edisi standard dan 4K\n\nEdisi standard mendokumentasikan MP4 pada 24 fps dan tempoh daripada 4 hingga 15 saat. Tahap output ialah 480p, 720p dan 1080p dengan kedalaman warna 8-bit, serta 4K dengan kedalaman warna 10-bit. Nisbah yang disokong ialah 21:9, 16:9, 4:3, 1:1, 3:4 dan 9:16. Pembingkaian adaptif dan pemilihan tempoh automatik turut didokumentasikan. Edisi Fast mempunyai spesifikasi output 480p/720p sendiri yang lebih terhad.\n\nOutput 4K menggunakan pengekodan H.265/HEVC. Pengekodan sepuluh bit mengekalkan lebih banyak gradasi tona dan peralihan warna lebih licin, yang penting untuk bahan dengan gradien cahaya atau warna halus. Periksa bahawa persekitaran main balik dan penyuntingan sasaran boleh menyahkod format tersebut; sesetengah pelayar dan peranti tidak memainkannya secara terus. Bekas fail yang serasi tidak semestinya memastikan penyahkodan video yang serasi.\n\nModel boleh menjana bunyi terselaras atau video senyap, dan boleh memulangkan bingkai terakhir yang dijana untuk adegan berikutnya. Audio janaan ialah mono. Keluarga 2.0 tidak menyokong mod pratonton Draft dua peringkat yang berasingan, jadi ciri pratonton itu tidak patut disimpulkan daripada edisi Seedance lain.\n\n### Persediaan rujukan dan batas penting\n\nKapasiti rujukan yang didokumentasikan ialah sehingga sembilan imej, tiga video dan tiga klip audio. Muat naik terus imej atau video rujukan yang mengandungi wajah manusia sebenar tidak diterima dalam profil pengeluar yang didokumentasikan ini; kerja potret menggunakan aliran kerja aset potret yang disokongnya. Setiap klip video dan audio mesti sepanjang 2–15 saat. Semua rujukan video bersama mesti muat dalam 15 saat, manakala semua rujukan audio bersama mempunyai jumlah 15 saatnya sendiri. Fail video menggunakan MP4 atau MOV pada 24–60 fps, sehingga 200 MB setiap satu; fail audio menggunakan WAV atau MP3, sehingga 15 MB setiap satu. Format imej yang disenaraikan ialah JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC dan HEIF. Setiap imej mesti lebih kecil daripada 30 MB, dan badan permintaan tidak boleh melebihi 64 MB. Dalam profil input rujukan yang didokumentasikan, lebar dan tinggi imej masing-masing mesti melebihi 300 dan kurang daripada 6,000 piksel, dengan nisbah lebar kepada tinggi melebihi 0.4 dan kurang daripada 2.5. Video rujukan membenarkan 300–6,000 piksel bagi setiap dimensi dan nisbah 0.4–2.5, termasuk nilai sempadan, dengan jumlah 407,696–8,295,044 piksel. Video MP4 atau MOV menggunakan video H.264/AVC atau H.265/HEVC dan audio AAC atau MP3.\n\nSusun fail dengan sengaja dan rujuk setiap satunya melalui jenis media dan nombor: Image 1, Video 1 dan Audio 1. Nombor mengikut susunan antara fail daripada jenis itu. Jelaskan ciri yang perlu dipindahkan dan kandungan sumber yang tidak patut menentukan adegan baharu. Bahasa prompt yang didokumentasikan merangkumi bahasa Inggeris, Sepanyol, Indonesia, Portugis dan Jepun. Kekalkan bahasa pertuturan yang konsisten dalam dialog; panduan menasihatkan supaya tidak mencampurkan bahasa kecuali nama khas. Untuk kerja berpandukan suara, asingkan penutur, baris yang tepat dan arahan penyampaian.\n\nSediakan imej pertama dan terakhir dengan pembingkaian yang serasi. Ketidakpadanan antara gambar input dengan dimensi output boleh menyebabkan pemangkasan atau perubahan visual mendadak; dimensi sepadan dan pembingkaian adaptif ialah penyelesaian yang didokumentasikan. Tumpukan penerangan pada peristiwa dan peranan rujukan. Pengeluar memberi amaran bahawa prompt panjang boleh menyebarkan maklumat sehingga butiran diabaikan. Semak gerakan yang terhasil, kesinambungan rujukan, persembahan audio dan titik sambungan antara adegan sebagai bahagian berbeza hasil kreatif.\n\n### Perancangan syot dan pengarahan teks\n\nUntuk adegan kompleks, susun taklimat sebagai Shot 1, Shot 2 dan Shot 3, dengan menetapkan kamera, tindakan subjek, kedudukan dan bunyi mengikut urutan. Panduan mengesyorkan satu gerak kamera bagi setiap syot dan mengutamakan tindakan perlahan yang bersambung. Cap masa tepat bagi setiap syot tidak stabil, maka urutan peristiwa ialah kawalan yang lebih baik daripada memaksa beberapa tetingkap masa tepat.\n\nModel turut menjana teks lazim, termasuk slogan, sari kata dan gelembung pertuturan. Anda boleh mengarahkan warna, olahan visual, lokasi dan kemunculan teks. Gunakan aksara lazim, bukannya aksara jarang atau simbol khas, dan semak perkataannya semasa bergerak. Untuk rujukan subjek, kaitkan setiap aset dengan jelas kepada watak atau objek yang dimaksudkan. Sudut pandangan produk boleh membekalkan maklumat visual berbeza; kolaj watak dari pelbagai sudut boleh mengelirukan identiti wajah. Potret kepala jelas dan imej seluruh badan yang berasingan ialah cadangan rujukan watak yang didokumentasikan.\n\n### Tingkah laku untuk diperiksa sebelum suntingan\n\nPanduan mendokumentasikan sari kata, logo, watak pendua dan penyimpangan gaya yang tidak dikehendaki. Bahan sumber bersih, label konsisten dan kekangan jelas mengurangkan risiko itu, tetapi tidak menjamin teks atau figura pendua yang tidak dikehendaki hilang. Lebih daripada empat orang rujukan dilaporkan sebagai risiko kestabilan, yang berbeza daripada bilangan fail yang diterima model.\n\nPemanjangan video boleh menghasilkan lompatan atau pengunduran pada titik sambungan, dan sambungan berulang boleh menggandakan kemerosotan kualiti imej. Periksa bingkai sempadan dan hadkan pemanjangan bertindan. Suara rujukan boleh berbeza daripada timbre sumber; narasi mungkin berakhir dengan bunyi klik atau terputus secara mendadak, yang boleh diatasi dengan pemudaran audio seperti didokumentasikan. Aksara Cina polifonik, jarang atau berbentuk serupa boleh disebut secara salah. Untuk kesan animasi tepat, seperti kira detik, rujukan gerakan lebih bermaklumat daripada permintaan lisan sahaja. Ini ialah sebab konkrit untuk memeriksa identiti, teks, gerakan dan bunyi secara berasingan apabila memilih klip.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a6485049eed85dd7ff1e9fd9a188525655f644675860fea20b56d37eb589506a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "
•

ByteDance: Seedance 2.0

ByteDance /bytedance/seedance-2.0

Pengenalan

ByteDance Seedance 2.0 menggabungkan penjanaan audio-video natif dengan rujukan imej, video dan bunyi. Arahkan adegan baharu, sunting rakaman sedia ada atau panjangkan urutan; edisi standard merangkumi output 1080p dan 4K 10-bit yang didokumentasikan.

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

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

Seedance 2.0 ialah model standard ByteDance Seed untuk penciptaan audio-video multimodal. Ia menggabungkan teks, imej, video dan audio dalam seni bina penjanaan bersama, dengan aliran kerja kreatif berasingan untuk adegan berpandukan rujukan, penyuntingan video dan pemanjangan video. Ia berguna apabila taklimat memerlukan persembahan koheren serta maklumat visual atau bunyi tertentu daripada bahan yang disediakan.

Rujukan multimodal dan kawalan pengarahan

Imej boleh menentukan rupa subjek, gaya visual dan komposisi. Rujukan video boleh membimbing tindakan, gerak kamera dan kesan. Audio boleh membimbing timbre suara, muzik atau dialog. Tentukan peranan setiap bahan, kemudian terangkan adegan yang patut terhasil. Pengeluar menekankan kawalan persembahan, pencahayaan, bayang-bayang dan bahasa kamera.

Untuk cerita produk, sediakan gambar produk, rujukan gerak kamera dan petunjuk audio. Taklimat boleh berbunyi: “Kekalkan pasu kaca biru daripada Image 1. Gunakan gerakan penjejakan sisi perlahan daripada Video 1. Pasu berada di rak yang disinari matahari, dengan muzik instrumental lembut berasaskan Audio 1.” Output yang dimaksudkan ialah adegan yang dipentaskan semula dan menggabungkan maklumat rujukan terpilih.

Input rujukan boleh menggabungkan imej dengan audio, imej dengan video, video dengan audio atau ketiga-tiganya. Input audio sahaja dan teks bersama audio tanpa imej atau video tidak disokong. Teks-ke-video tradisional, penjanaan bingkai pertama dan penjanaan bingkai pertama serta terakhir turut didokumentasikan. Jika komposisi pembukaan dan penutup tetap penting, gunakan aliran kerja titik akhir khusus: menamakan imej rujukan sebagai titik akhir dalam prompt omni-reference hanyalah cara tidak langsung untuk membimbingnya.

Menyunting rakaman

Model boleh menggantikan subjek, menambah atau membuang objek, mengubah unsur serta melukis semula atau membaiki bahagian video. Terangkan perubahan khusus dan kenal pasti rakaman sumber. Untuk penambahan, sertakan masa kemunculan dan kedudukan; untuk pembuangan atau penggantian, nyatakan objek dengan tepat dan namakan perkara yang patut kekal.

Contohnya: “Gantikan lampu meja dalam Video 1 dengan lampu loyang dalam Image 1. Kekalkan gerak kamera, susunan meja dan arah pencahayaan.” Hasil yang dikehendaki ialah versi suntingan adegan dengan penggantian yang dimaksudkan. Periksa kawasan yang tidak berubah serta objek baharu, khususnya semasa terlindung, bergerak dan bertukar syot.

Memanjangkan dan menghubungkan urutan

Seedance 2.0 boleh memanjangkan video ke hadapan atau ke belakang, serta menghubungkan sehingga tiga klip yang dibekalkan dengan peralihan janaan. Nyatakan arah masa dan peristiwa baharu. Untuk penghubung, susun klip dan terangkan peralihan antara setiap pasangan, seperti kamera memasuki pintu dalam satu syot dan tiba di persekitaran seterusnya.

Pemanjangan mudah biasanya memulangkan sambungan yang dibangunkan di sekitar rakaman sumber; sertakan arahan jelas jika hasil akhir patut mengulang segmen asal juga. Apabila melengkapkan penghubungan antara dua atau tiga klip, aliran kerja yang didokumentasikan boleh merangkumi bahan asal serta kandungan peralihan baharu. Ini berguna untuk mengembangkan pembukaan atau penutup, atau menghubungkan adegan yang disediakan tanpa membiarkan tindakan penyambung tidak ditentukan.

Output edisi standard dan 4K

Edisi standard mendokumentasikan MP4 pada 24 fps dan tempoh daripada 4 hingga 15 saat. Tahap output ialah 480p, 720p dan 1080p dengan kedalaman warna 8-bit, serta 4K dengan kedalaman warna 10-bit. Nisbah yang disokong ialah 21:9, 16:9, 4:3, 1:1, 3:4 dan 9:16. Pembingkaian adaptif dan pemilihan tempoh automatik turut didokumentasikan. Edisi Fast mempunyai spesifikasi output 480p/720p sendiri yang lebih terhad.

Output 4K menggunakan pengekodan H.265/HEVC. Pengekodan sepuluh bit mengekalkan lebih banyak gradasi tona dan peralihan warna lebih licin, yang penting untuk bahan dengan gradien cahaya atau warna halus. Periksa bahawa persekitaran main balik dan penyuntingan sasaran boleh menyahkod format tersebut; sesetengah pelayar dan peranti tidak memainkannya secara terus. Bekas fail yang serasi tidak semestinya memastikan penyahkodan video yang serasi.

Model boleh menjana bunyi terselaras atau video senyap, dan boleh memulangkan bingkai terakhir yang dijana untuk adegan berikutnya. Audio janaan ialah mono. Keluarga 2.0 tidak menyokong mod pratonton Draft dua peringkat yang berasingan, jadi ciri pratonton itu tidak patut disimpulkan daripada edisi Seedance lain.

Persediaan rujukan dan batas penting

Kapasiti rujukan yang didokumentasikan ialah sehingga sembilan imej, tiga video dan tiga klip audio. Muat naik terus imej atau video rujukan yang mengandungi wajah manusia sebenar tidak diterima dalam profil pengeluar yang didokumentasikan ini; kerja potret menggunakan aliran kerja aset potret yang disokongnya. Setiap klip video dan audio mesti sepanjang 2–15 saat. Semua rujukan video bersama mesti muat dalam 15 saat, manakala semua rujukan audio bersama mempunyai jumlah 15 saatnya sendiri. Fail video menggunakan MP4 atau MOV pada 24–60 fps, sehingga 200 MB setiap satu; fail audio menggunakan WAV atau MP3, sehingga 15 MB setiap satu. Format imej yang disenaraikan ialah JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC dan HEIF. Setiap imej mesti lebih kecil daripada 30 MB, dan badan permintaan tidak boleh melebihi 64 MB. Dalam profil input rujukan yang didokumentasikan, lebar dan tinggi imej masing-masing mesti melebihi 300 dan kurang daripada 6,000 piksel, dengan nisbah lebar kepada tinggi melebihi 0.4 dan kurang daripada 2.5. Video rujukan membenarkan 300–6,000 piksel bagi setiap dimensi dan nisbah 0.4–2.5, termasuk nilai sempadan, dengan jumlah 407,696–8,295,044 piksel. Video MP4 atau MOV menggunakan video H.264/AVC atau H.265/HEVC dan audio AAC atau MP3.

Susun fail dengan sengaja dan rujuk setiap satunya melalui jenis media dan nombor: Image 1, Video 1 dan Audio 1. Nombor mengikut susunan antara fail daripada jenis itu. Jelaskan ciri yang perlu dipindahkan dan kandungan sumber yang tidak patut menentukan adegan baharu. Bahasa prompt yang didokumentasikan merangkumi bahasa Inggeris, Sepanyol, Indonesia, Portugis dan Jepun. Kekalkan bahasa pertuturan yang konsisten dalam dialog; panduan menasihatkan supaya tidak mencampurkan bahasa kecuali nama khas. Untuk kerja berpandukan suara, asingkan penutur, baris yang tepat dan arahan penyampaian.

Sediakan imej pertama dan terakhir dengan pembingkaian yang serasi. Ketidakpadanan antara gambar input dengan dimensi output boleh menyebabkan pemangkasan atau perubahan visual mendadak; dimensi sepadan dan pembingkaian adaptif ialah penyelesaian yang didokumentasikan. Tumpukan penerangan pada peristiwa dan peranan rujukan. Pengeluar memberi amaran bahawa prompt panjang boleh menyebarkan maklumat sehingga butiran diabaikan. Semak gerakan yang terhasil, kesinambungan rujukan, persembahan audio dan titik sambungan antara adegan sebagai bahagian berbeza hasil kreatif.

Perancangan syot dan pengarahan teks

Untuk adegan kompleks, susun taklimat sebagai Shot 1, Shot 2 dan Shot 3, dengan menetapkan kamera, tindakan subjek, kedudukan dan bunyi mengikut urutan. Panduan mengesyorkan satu gerak kamera bagi setiap syot dan mengutamakan tindakan perlahan yang bersambung. Cap masa tepat bagi setiap syot tidak stabil, maka urutan peristiwa ialah kawalan yang lebih baik daripada memaksa beberapa tetingkap masa tepat.

Model turut menjana teks lazim, termasuk slogan, sari kata dan gelembung pertuturan. Anda boleh mengarahkan warna, olahan visual, lokasi dan kemunculan teks. Gunakan aksara lazim, bukannya aksara jarang atau simbol khas, dan semak perkataannya semasa bergerak. Untuk rujukan subjek, kaitkan setiap aset dengan jelas kepada watak atau objek yang dimaksudkan. Sudut pandangan produk boleh membekalkan maklumat visual berbeza; kolaj watak dari pelbagai sudut boleh mengelirukan identiti wajah. Potret kepala jelas dan imej seluruh badan yang berasingan ialah cadangan rujukan watak yang didokumentasikan.

Tingkah laku untuk diperiksa sebelum suntingan

Panduan mendokumentasikan sari kata, logo, watak pendua dan penyimpangan gaya yang tidak dikehendaki. Bahan sumber bersih, label konsisten dan kekangan jelas mengurangkan risiko itu, tetapi tidak menjamin teks atau figura pendua yang tidak dikehendaki hilang. Lebih daripada empat orang rujukan dilaporkan sebagai risiko kestabilan, yang berbeza daripada bilangan fail yang diterima model.

Pemanjangan video boleh menghasilkan lompatan atau pengunduran pada titik sambungan, dan sambungan berulang boleh menggandakan kemerosotan kualiti imej. Periksa bingkai sempadan dan hadkan pemanjangan bertindan. Suara rujukan boleh berbeza daripada timbre sumber; narasi mungkin berakhir dengan bunyi klik atau terputus secara mendadak, yang boleh diatasi dengan pemudaran audio seperti didokumentasikan. Aksara Cina polifonik, jarang atau berbentuk serupa boleh disebut secara salah. Untuk kesan animasi tepat, seperti kira detik, rujukan gerakan lebih bermaklumat daripada permintaan lisan sahaja. Ini ialah sebab konkrit untuk memeriksa identiti, teks, gerakan dan bunyi secara berasingan apabila memilih klip.

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Video POST /v1/videos
Input
text, image, audio
Output
video
Format output
bait MP4 asal; tanpa penormalan atau pengekodan semula
MedanJenisKeperluanNilai & hadLalai
MedanmodelJenisstringKeperluanDiperlukanNilai & had
bytedance/seedance-2.0
Lalai—
MedanpromptJenisstringKeperluanDiperlukanNilai & hadLalai—
MedandurationJenisintegerKeperluanDiperlukanNilai & had
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maksimum: 600
Lalai—
MedanresolutionJenisstringKeperluanPilihanNilai & had
480p, 720p, 1080p, 4K
Lalai—
Medanaspect_ratioJenisstringKeperluanPilihanNilai & had
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Lalai—
Medangenerate_audioJenisbooleanKeperluanPilihanNilai & had
false, true
Syarat: Pada 480p dan 720p, menggugurkan generate_audio memilih harga dengan audio, manakala false memilih harga tanpa audio. Pada 1080p dan 4K, harga resolusi digunakan bagi kedua-dua tetapan. Semak has_audio dalam hasil untuk trek audio yang dikembalikan.
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=first_frame atau last_frame. Setiap peranan boleh muncul paling banyak sekali. Gunakan pautan HTTPS awam.
Kunci tepat: type, image_url, frame_type
Syarat: Kunci ini digunakan bagi setiap objek bingkai. Gugurkan frame_images untuk permintaan teks sahaja.
Lalai—
Medaninput_referencesJenisarrayKeperluanPilihanNilai & had
Kandungan input: Tatasusunan objek rujukan imej atau audio. Tetapkan type kepada image_url atau audio_url dan berikan objek URL sepadan yang mengandungi url. Harga rujukan video masih tidak dapat ditentukan.
Syarat: Gugurkan frame_images untuk menggunakan mod rujukan. Gunakan pautan HTTPS awam.
Lalai—
MedansizeJenisstringKeperluanPilihanNilai & had
480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160
Corak: ^[1-9][0-9]*x[1-9][0-9]*$
Lalai—
MedanseedJenisintegerKeperluanPilihanNilai & had
Minimum: -9,223,372,036,854,775,808
Maksimum: 9,223,372,036,854,775,807
Lalai—
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 teks dan tempoh dalam saat bulat yang disokong. Gunakan saiz tepat yang disenaraikan, atau resolusi dan nisbah bidang yang menghasilkan dimensi yang disenaraikan.

model: Jenis: string · bytedance/seedance-2.0

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

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

frame_images ialah tatasusunan objek dengan type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS awam; first_frame dan last_frame masing-masing boleh muncul sekali. Gunakan saiz output yang disenaraikan atau dimensi yang serasi. Jangan tambah rujukan video.

Kunci tepat: type, image_url, frame_type

model: Jenis: string · bytedance/seedance-2.0

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

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

input_references ialah tatasusunan. Setiap objek mempunyai type=image_url atau type=audio_url serta objek URL sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Harga rujukan video tidak dapat ditentukan.

model: Jenis: string · bytedance/seedance-2.0

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
Parameteradditional_propertiesKontrakfalse
Parameteroptional_controlsKontrakresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, 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 token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini.Caj
Output · Harga token video · Anggaran untuk perbandingan sahaja $0.014 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilanresolution: 1080pCaj
Output · Harga token video · Anggaran untuk perbandingan sahaja $0.0154 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilanjenis input: with_video_input; resolusi: 1080pCaj
reference · Harga token video · Anggaran untuk perbandingan sahaja $0.0094 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilanresolution: 4kCaj
Output · Harga token video · Anggaran untuk perbandingan sahaja $0.008 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilanjenis input: with_video_input; resolusi: 4kCaj
reference · Harga token video · Anggaran untuk perbandingan sahaja $0.0048 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilanjenis input: with_video_inputCaj
reference · Harga token video · Anggaran untuk perbandingan sahaja $0.0086 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap 1K token videoSyarat pengebilantetapan audio: without_audioCaj
Output · Harga token video · Anggaran untuk perbandingan sahaja $0.014 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiAnggaran kos penjanaanJadual kadar—Kuantiti ramalananggaran untuk satu penjanaanUnit pengebilan—Syarat pengebilan—Caj
Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.3024 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 token videoSyarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini.Caj
Output · Harga token video $0.014 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoSyarat pengebilanresolution: 4kCaj
Output · Harga token video $0.008 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoSyarat pengebilanresolution: 1080pCaj
Output · Harga token video $0.0154 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoSyarat pengebilantetapan audio: without_audioCaj
Output · Harga token video $0.014 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoSyarat pengebilanjenis input: with_video_inputCaj
reference · Harga token video $0.0086 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoSyarat pengebilanjenis input: with_video_input; resolusi: 4kCaj
reference · Harga token video $0.0048 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

KonfigurasiHarga token videoSyarat pengebilanjenis input: with_video_input; resolusi: 1080pCaj
reference · Harga token video $0.0094 bagi setiap 1K token video

Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.

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('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', 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 bytedance/seedance-2.0

Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

ID pemanggil berkaitan

bytedance/seedance-2.0

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0", "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": [ "bytedance/seedance-2.0" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Berikan prompt teks dan tempoh dalam saat bulat yang disokong. Gunakan saiz tepat yang disenaraikan, atau resolusi dan nisbah bidang yang menghasilkan dimensi yang disenaraikan.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt bertulis." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ialah tatasusunan objek dengan type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS awam; first_frame dan last_frame masing-masing boleh muncul sekali. Gunakan saiz output yang disenaraikan atau dimensi yang serasi. Jangan tambah rujukan video.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt bertulis dan imej bingkai." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references ialah tatasusunan. Setiap objek mempunyai type=image_url atau type=audio_url serta objek URL sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Harga rujukan video tidak dapat ditentukan.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Prompt bertulis dan rujukan imej atau audio." } ], "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": [ "bytedance/seedance-2.0" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0" }, "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": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 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": [ "480p", "720p", "1080p", "4K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p", "1080p", "4K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Pada 480p dan 720p, menggugurkan generate_audio memilih harga dengan audio, manakala false memilih harga tanpa audio. Pada 1080p dan 4K, harga resolusi digunakan bagi kedua-dua tetapan. Semak has_audio dalam hasil untuk trek audio yang dikembalikan.", "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 digunakan bagi setiap objek bingkai. 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=first_frame atau last_frame. Setiap peranan boleh muncul paling banyak sekali. Gunakan pautan HTTPS awam.", "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", "conditions": "Gugurkan frame_images untuk menggunakan mod rujukan. Gunakan pautan HTTPS awam.", "content": "Tatasusunan objek rujukan imej atau audio. Tetapkan type kepada image_url atau audio_url dan berikan objek URL sepadan yang mengandungi url. Harga rujukan video masih tidak dapat ditentukan.", "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": { "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": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720", "1080x1080", "1080x1440", "1080x1920", "1440x1080", "1920x1080", "2520x1080", "3840x2160", "2160x3840", "2160x2160", "2880x2160", "2160x2880", "5040x2160" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720", "1080x1080", "1080x1440", "1080x1920", "1440x1080", "1920x1080", "2520x1080", "3840x2160", "2160x3840", "2160x2160", "2880x2160", "2160x2880", "5040x2160" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "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": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "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": [ 4, 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": { "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": "bytedance/seedance-2.0" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p", "1080p", "4K" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720", "1080x1080", "1080x1440", "1080x1920", "1440x1080", "1920x1080", "2520x1080", "3840x2160", "2160x3840", "2160x2160", "2880x2160", "2160x2880", "5040x2160" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "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.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "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" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "input: with_video_input; resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "resolution: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k", "label": "Video-token price", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "jenis input: with_video_input; resolusi: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "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": "0.3024", "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": "0.3024", "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('{\"model\":\"bytedance/seedance-2.0\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', 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" ], "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" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input; resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "resolution: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k", "label": "Video-token price", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input; resolution: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "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": "0.3024", "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": "0.3024", "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": "bytedance/seedance-2.0", "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.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k", "label": "Video-token price", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.3024", "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": "0.3024", "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": "bytedance/seedance-2.0", "nativeProvenance": { "input_facts_canonical_sha256": "922fd76785dd91930d5bb23c0f12f8cf645834279b1171bab6b5007e7e0bce13", "input_html_sha256": "6d77e24feb8d25199662c613b2b514f73556a676344f4543f3ed3acc21335da8", "private_audit_sha256": "72e090a6830067f3b6fe247ad4b8c9935ae4e96846693f5e923f52cd7faea276", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ms/bytedance-seedance-2-0/", "description": "ByteDance Seedance 2.0 menggabungkan penjanaan audio-video natif dengan rujukan imej, video dan bunyi. Arahkan adegan baharu, sunting rakaman sedia ada atau panjangkan urutan; edisi standard merangkumi output 1080p dan 4K 10-bit yang didokumentasikan.", "locale": "ms", "md_url": "https://ailoot.ai/models/ms/bytedance-seedance-2-0/index.md", "title": "ByteDance: Seedance 2.0 — Ailoot", "url": "https://ailoot.ai/models/ms/bytedance-seedance-2-0/" }, "rawModel": { "about": "Seedance 2.0 ialah model standard ByteDance Seed untuk penciptaan audio-video multimodal. Ia menggabungkan teks, imej, video dan audio dalam seni bina penjanaan bersama, dengan aliran kerja kreatif berasingan untuk adegan berpandukan rujukan, penyuntingan video dan pemanjangan video. Ia berguna apabila taklimat memerlukan persembahan koheren serta maklumat visual atau bunyi tertentu daripada bahan yang disediakan.\n\n### Rujukan multimodal dan kawalan pengarahan\n\nImej boleh menentukan rupa subjek, gaya visual dan komposisi. Rujukan video boleh membimbing tindakan, gerak kamera dan kesan. Audio boleh membimbing timbre suara, muzik atau dialog. Tentukan peranan setiap bahan, kemudian terangkan adegan yang patut terhasil. Pengeluar menekankan kawalan persembahan, pencahayaan, bayang-bayang dan bahasa kamera.\n\nUntuk cerita produk, sediakan gambar produk, rujukan gerak kamera dan petunjuk audio. Taklimat boleh berbunyi: “Kekalkan pasu kaca biru daripada Image 1. Gunakan gerakan penjejakan sisi perlahan daripada Video 1. Pasu berada di rak yang disinari matahari, dengan muzik instrumental lembut berasaskan Audio 1.” Output yang dimaksudkan ialah adegan yang dipentaskan semula dan menggabungkan maklumat rujukan terpilih.\n\nInput rujukan boleh menggabungkan imej dengan audio, imej dengan video, video dengan audio atau ketiga-tiganya. Input audio sahaja dan teks bersama audio tanpa imej atau video tidak disokong. Teks-ke-video tradisional, penjanaan bingkai pertama dan penjanaan bingkai pertama serta terakhir turut didokumentasikan. Jika komposisi pembukaan dan penutup tetap penting, gunakan aliran kerja titik akhir khusus: menamakan imej rujukan sebagai titik akhir dalam prompt omni-reference hanyalah cara tidak langsung untuk membimbingnya.\n\n### Menyunting rakaman\n\nModel boleh menggantikan subjek, menambah atau membuang objek, mengubah unsur serta melukis semula atau membaiki bahagian video. Terangkan perubahan khusus dan kenal pasti rakaman sumber. Untuk penambahan, sertakan masa kemunculan dan kedudukan; untuk pembuangan atau penggantian, nyatakan objek dengan tepat dan namakan perkara yang patut kekal.\n\nContohnya: “Gantikan lampu meja dalam Video 1 dengan lampu loyang dalam Image 1. Kekalkan gerak kamera, susunan meja dan arah pencahayaan.” Hasil yang dikehendaki ialah versi suntingan adegan dengan penggantian yang dimaksudkan. Periksa kawasan yang tidak berubah serta objek baharu, khususnya semasa terlindung, bergerak dan bertukar syot.\n\n### Memanjangkan dan menghubungkan urutan\n\nSeedance 2.0 boleh memanjangkan video ke hadapan atau ke belakang, serta menghubungkan sehingga tiga klip yang dibekalkan dengan peralihan janaan. Nyatakan arah masa dan peristiwa baharu. Untuk penghubung, susun klip dan terangkan peralihan antara setiap pasangan, seperti kamera memasuki pintu dalam satu syot dan tiba di persekitaran seterusnya.\n\nPemanjangan mudah biasanya memulangkan sambungan yang dibangunkan di sekitar rakaman sumber; sertakan arahan jelas jika hasil akhir patut mengulang segmen asal juga. Apabila melengkapkan penghubungan antara dua atau tiga klip, aliran kerja yang didokumentasikan boleh merangkumi bahan asal serta kandungan peralihan baharu. Ini berguna untuk mengembangkan pembukaan atau penutup, atau menghubungkan adegan yang disediakan tanpa membiarkan tindakan penyambung tidak ditentukan.\n\n### Output edisi standard dan 4K\n\nEdisi standard mendokumentasikan MP4 pada 24 fps dan tempoh daripada 4 hingga 15 saat. Tahap output ialah 480p, 720p dan 1080p dengan kedalaman warna 8-bit, serta 4K dengan kedalaman warna 10-bit. Nisbah yang disokong ialah 21:9, 16:9, 4:3, 1:1, 3:4 dan 9:16. Pembingkaian adaptif dan pemilihan tempoh automatik turut didokumentasikan. Edisi Fast mempunyai spesifikasi output 480p/720p sendiri yang lebih terhad.\n\nOutput 4K menggunakan pengekodan H.265/HEVC. Pengekodan sepuluh bit mengekalkan lebih banyak gradasi tona dan peralihan warna lebih licin, yang penting untuk bahan dengan gradien cahaya atau warna halus. Periksa bahawa persekitaran main balik dan penyuntingan sasaran boleh menyahkod format tersebut; sesetengah pelayar dan peranti tidak memainkannya secara terus. Bekas fail yang serasi tidak semestinya memastikan penyahkodan video yang serasi.\n\nModel boleh menjana bunyi terselaras atau video senyap, dan boleh memulangkan bingkai terakhir yang dijana untuk adegan berikutnya. Audio janaan ialah mono. Keluarga 2.0 tidak menyokong mod pratonton Draft dua peringkat yang berasingan, jadi ciri pratonton itu tidak patut disimpulkan daripada edisi Seedance lain.\n\n### Persediaan rujukan dan batas penting\n\nKapasiti rujukan yang didokumentasikan ialah sehingga sembilan imej, tiga video dan tiga klip audio. Muat naik terus imej atau video rujukan yang mengandungi wajah manusia sebenar tidak diterima dalam profil pengeluar yang didokumentasikan ini; kerja potret menggunakan aliran kerja aset potret yang disokongnya. Setiap klip video dan audio mesti sepanjang 2–15 saat. Semua rujukan video bersama mesti muat dalam 15 saat, manakala semua rujukan audio bersama mempunyai jumlah 15 saatnya sendiri. Fail video menggunakan MP4 atau MOV pada 24–60 fps, sehingga 200 MB setiap satu; fail audio menggunakan WAV atau MP3, sehingga 15 MB setiap satu. Format imej yang disenaraikan ialah JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC dan HEIF. Setiap imej mesti lebih kecil daripada 30 MB, dan badan permintaan tidak boleh melebihi 64 MB. Dalam profil input rujukan yang didokumentasikan, lebar dan tinggi imej masing-masing mesti melebihi 300 dan kurang daripada 6,000 piksel, dengan nisbah lebar kepada tinggi melebihi 0.4 dan kurang daripada 2.5. Video rujukan membenarkan 300–6,000 piksel bagi setiap dimensi dan nisbah 0.4–2.5, termasuk nilai sempadan, dengan jumlah 407,696–8,295,044 piksel. Video MP4 atau MOV menggunakan video H.264/AVC atau H.265/HEVC dan audio AAC atau MP3.\n\nSusun fail dengan sengaja dan rujuk setiap satunya melalui jenis media dan nombor: Image 1, Video 1 dan Audio 1. Nombor mengikut susunan antara fail daripada jenis itu. Jelaskan ciri yang perlu dipindahkan dan kandungan sumber yang tidak patut menentukan adegan baharu. Bahasa prompt yang didokumentasikan merangkumi bahasa Inggeris, Sepanyol, Indonesia, Portugis dan Jepun. Kekalkan bahasa pertuturan yang konsisten dalam dialog; panduan menasihatkan supaya tidak mencampurkan bahasa kecuali nama khas. Untuk kerja berpandukan suara, asingkan penutur, baris yang tepat dan arahan penyampaian.\n\nSediakan imej pertama dan terakhir dengan pembingkaian yang serasi. Ketidakpadanan antara gambar input dengan dimensi output boleh menyebabkan pemangkasan atau perubahan visual mendadak; dimensi sepadan dan pembingkaian adaptif ialah penyelesaian yang didokumentasikan. Tumpukan penerangan pada peristiwa dan peranan rujukan. Pengeluar memberi amaran bahawa prompt panjang boleh menyebarkan maklumat sehingga butiran diabaikan. Semak gerakan yang terhasil, kesinambungan rujukan, persembahan audio dan titik sambungan antara adegan sebagai bahagian berbeza hasil kreatif.\n\n### Perancangan syot dan pengarahan teks\n\nUntuk adegan kompleks, susun taklimat sebagai Shot 1, Shot 2 dan Shot 3, dengan menetapkan kamera, tindakan subjek, kedudukan dan bunyi mengikut urutan. Panduan mengesyorkan satu gerak kamera bagi setiap syot dan mengutamakan tindakan perlahan yang bersambung. Cap masa tepat bagi setiap syot tidak stabil, maka urutan peristiwa ialah kawalan yang lebih baik daripada memaksa beberapa tetingkap masa tepat.\n\nModel turut menjana teks lazim, termasuk slogan, sari kata dan gelembung pertuturan. Anda boleh mengarahkan warna, olahan visual, lokasi dan kemunculan teks. Gunakan aksara lazim, bukannya aksara jarang atau simbol khas, dan semak perkataannya semasa bergerak. Untuk rujukan subjek, kaitkan setiap aset dengan jelas kepada watak atau objek yang dimaksudkan. Sudut pandangan produk boleh membekalkan maklumat visual berbeza; kolaj watak dari pelbagai sudut boleh mengelirukan identiti wajah. Potret kepala jelas dan imej seluruh badan yang berasingan ialah cadangan rujukan watak yang didokumentasikan.\n\n### Tingkah laku untuk diperiksa sebelum suntingan\n\nPanduan mendokumentasikan sari kata, logo, watak pendua dan penyimpangan gaya yang tidak dikehendaki. Bahan sumber bersih, label konsisten dan kekangan jelas mengurangkan risiko itu, tetapi tidak menjamin teks atau figura pendua yang tidak dikehendaki hilang. Lebih daripada empat orang rujukan dilaporkan sebagai risiko kestabilan, yang berbeza daripada bilangan fail yang diterima model.\n\nPemanjangan video boleh menghasilkan lompatan atau pengunduran pada titik sambungan, dan sambungan berulang boleh menggandakan kemerosotan kualiti imej. Periksa bingkai sempadan dan hadkan pemanjangan bertindan. Suara rujukan boleh berbeza daripada timbre sumber; narasi mungkin berakhir dengan bunyi klik atau terputus secara mendadak, yang boleh diatasi dengan pemudaran audio seperti didokumentasikan. Aksara Cina polifonik, jarang atau berbentuk serupa boleh disebut secara salah. Untuk kesan animasi tepat, seperti kira detik, rujukan gerakan lebih bermaklumat daripada permintaan lisan sahaja. Ini ialah sebab konkrit untuk memeriksa identiti, teks, gerakan dan bunyi secara berasingan apabila memilih klip.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.3024", "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": "0.3024", "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": "cb128050bf8483dc92f31388", "label": "Rujukan harga konfigurasi video", "profiles": [ { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "Tiada syarat tambahan dinyatakan dalam kunci harga ini." }, "label": "Harga token video", "units": [ { "amount": "0.014", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "resolution: 4k" }, "label": "Harga token video", "units": [ { "amount": "0.008", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "resolution: 1080p" }, "label": "Harga token video", "units": [ { "amount": "0.0154", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "tetapan audio: without_audio" }, "label": "Harga token video", "units": [ { "amount": "0.014", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "jenis input: with_video_input" }, "label": "Harga token video", "units": [ { "amount": "0.0086", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "jenis input: with_video_input; resolusi: 4k" }, "label": "Harga token video", "units": [ { "amount": "0.0048", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "jenis input: with_video_input; resolusi: 1080p" }, "label": "Harga token video", "units": [ { "amount": "0.0094", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0", "input": [ "text", "image", "audio" ], "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": [ "bytedance/seedance-2.0" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Berikan prompt teks dan tempoh dalam saat bulat yang disokong. Gunakan saiz tepat yang disenaraikan, atau resolusi dan nisbah bidang yang menghasilkan dimensi yang disenaraikan.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt bertulis." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ialah tatasusunan objek dengan type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS awam; first_frame dan last_frame masing-masing boleh muncul sekali. Gunakan saiz output yang disenaraikan atau dimensi yang serasi. Jangan tambah rujukan video.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt bertulis dan imej bingkai." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references ialah tatasusunan. Setiap objek mempunyai type=image_url atau type=audio_url serta objek URL sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Harga rujukan video tidak dapat ditentukan.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Prompt bertulis dan rujukan imej atau audio." } ], "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": [ "bytedance/seedance-2.0" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0" }, "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": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 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": [ "480p", "720p", "1080p", "4K" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p", "1080p", "4K" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Pada 480p dan 720p, menggugurkan generate_audio memilih harga dengan audio, manakala false memilih harga tanpa audio. Pada 1080p dan 4K, harga resolusi digunakan bagi kedua-dua tetapan. Semak has_audio dalam hasil untuk trek audio yang dikembalikan.", "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 digunakan bagi setiap objek bingkai. 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=first_frame atau last_frame. Setiap peranan boleh muncul paling banyak sekali. Gunakan pautan HTTPS awam.", "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", "conditions": "Gugurkan frame_images untuk menggunakan mod rujukan. Gunakan pautan HTTPS awam.", "content": "Tatasusunan objek rujukan imej atau audio. Tetapkan type kepada image_url atau audio_url dan berikan objek URL sepadan yang mengandungi url. Harga rujukan video masih tidak dapat ditentukan.", "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": { "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": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720", "1080x1080", "1080x1440", "1080x1920", "1440x1080", "1920x1080", "2520x1080", "3840x2160", "2160x3840", "2160x2160", "2880x2160", "2160x2880", "5040x2160" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720", "1080x1080", "1080x1440", "1080x1920", "1440x1080", "1920x1080", "2520x1080", "3840x2160", "2160x3840", "2160x2160", "2880x2160", "2160x2880", "5040x2160" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "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": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "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": [ 4, 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": { "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": "bytedance/seedance-2.0" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p", "1080p", "4K" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720", "1080x1080", "1080x1440", "1080x1920", "1440x1080", "1920x1080", "2520x1080", "3840x2160", "2160x3840", "2160x2160", "2880x2160", "2160x2880", "5040x2160" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "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.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "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" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "input: with_video_input; resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "resolution: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k", "label": "Video-token price", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "jenis input: with_video_input; resolusi: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "Kadar token video ialah rujukan harga utama. Anggaran harga setiap saat yang dipaparkan sebagai ringkasan ialah rujukan berasingan, bukan caj tambahan.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Harga token video", "units": [ { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "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": "0.3024", "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": "0.3024", "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('{\"model\":\"bytedance/seedance-2.0\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', 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" ], "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" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input; resolution: 1080p", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "resolution: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k", "label": "Video-token price", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input; resolution: 4k", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "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": "0.3024", "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": "0.3024", "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": "bytedance/seedance-2.0", "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.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_1080p_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k", "label": "Video-token price", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_4k_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.3024", "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": "0.3024", "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": "bytedance/seedance-2.0", "request_model_id": "bytedance/seedance-2.0", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.3024, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.3024, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.000014", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000086", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "1080p" }, "label": "Ultra", "units": [ { "amount": "0.0000154", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "1080p" }, "key": "base", "label": "base", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "1080p" }, "label": "Ultra", "units": [ { "amount": "0.0000094", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "1080p" }, "key": "base", "label": "base", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "4K" }, "label": "Ultra", "units": [ { "amount": "0.000008", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "4K" }, "key": "base", "label": "base", "profile_index": 4, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "4K" }, "label": "Ultra", "units": [ { "amount": "0.0000048", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "4K" }, "key": "base", "label": "base", "profile_index": 5, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.000014", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.008000", "amount_unit": "usd_per_thousand_tokens", "basis": "resolution=4k", "billing_original_currency": "USD", "billing_original_rate": "0.000008", "key": "video_tokens_4k", "label": "video token", "native_amount_usd_per_unit": "0.000008", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0154000", "amount_unit": "usd_per_thousand_tokens", "basis": "resolution=1080p", "billing_original_currency": "USD", "billing_original_rate": "0.0000154", "key": "video_tokens_1080p", "label": "video token", "native_amount_usd_per_unit": "0.0000154", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.014000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.000014", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.000014", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0086000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.0000086", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.0000086", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0048000", "amount_unit": "usd_per_thousand_tokens", "basis": "resolution=4k · video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.0000048", "key": "video_tokens_4k_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.0000048", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0094000", "amount_unit": "usd_per_thousand_tokens", "basis": "resolution=1080p · video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.0000094", "key": "video_tokens_1080p_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.0000094", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0", "short": "ByteDance Seedance 2.0 menggabungkan penjanaan audio-video natif dengan rujukan imej, video dan bunyi. Arahkan adegan baharu, sunting rakaman sedia ada atau panjangkan urutan; edisi standard merangkumi output 1080p dan 4K 10-bit yang didokumentasikan." }, "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": "ByteDance Seedance 2.0 menggabungkan penjanaan audio-video natif dengan rujukan imej, video dan bunyi. Arahkan adegan baharu, sunting rakaman sedia ada atau panjangkan urutan; edisi standard merangkumi output 1080p dan 4K 10-bit yang didokumentasikan.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "30809c65c787741aadcbe52dcabae0ab343c1a46536584b496d8b8bb21b11b40", "raw_model_js_projection_sha256": "023162e5133c8ec2010746d836018cc333d79992cc59645d2f493773d4dc8dab", "raw_model_json_sha256": "30809c65c787741aadcbe52dcabae0ab343c1a46536584b496d8b8bb21b11b40", "renderer_sha256": "1dab5ba62521e9568c8b7c82005622cabbf330a075df7cce1f83274a04009460" }, "sourceRevision": "61c7d7f51a5568859338933f8cd755f038c9b782ca418680ac74705dd68cabf2" }