{ "aboutHtml": "

Kling VIDEO O1 ialah model video bersepadu Kuaishou yang berpandukan rujukan. Ia menggabungkan penerangan teks dengan imej, unsur subjek yang disediakan atau video sumber untuk membimbing adegan baharu dan perubahan tertumpu pada rakaman sedia ada. Antara muka terasnya ialah taklimat visual: kenal pasti bahan yang dirujuk, terangkan peranannya dan nyatakan rupa, tindakan atau transformasi yang dikehendaki dalam video terhasil.

Syot baharu boleh bermula daripada teks, imej pembukaan atau set rujukan visual. Gunakan imej untuk menetapkan watak atau objek, dan terangkan latar, tindakan serta sudut pandangan dalam kata-kata. Apabila beberapa rujukan menyumbang ciri berbeza, tetapkan peranannya secara jelas. Taklimat produk asal boleh mengambil objek daripada satu imej dan persekitaran daripada imej lain, kemudian menerangkan pergerakan objek dalam latar itu.

Prompt O1 boleh menamakan imej, unsur dan video dengan penanda rujukan tertentu, seperti <<<image_1>>> atau <<<video_1>>>. Kekalkan perkaitan penanda itu dengan aset sebenar yang dibekalkan dan jelaskan apa yang patut diambil daripadanya. Had prompt pembuat ialah 2,500 aksara. Arahan ringkas yang mengenal pasti subjek dan perubahan lebih berguna daripada himpunan istilah gaya yang tidak berkaitan.

Untuk rujukan berasaskan imej tanpa input video, had gabungan yang didokumentasikan ialah sehingga tujuh imej rujukan dan unsur berbilang imej. Dengan video rujukan, had imej/unsur itu ialah empat. Had ini terpakai kepada unsur berasaskan imej; jenis unsur lain mempunyai peraturan keserasian berasingan. Pilih bahan yang membekalkan maklumat rupa atau adegan penting, bukannya memenuhi had dengan pandangan berlebihan.

Input imej menggunakan JPG, JPEG atau PNG, dibekalkan sebagai URL boleh dicapai atau data imej, dengan fail sehingga 10 MB, dimensi sekurang-kurangnya 300 piksel dan nisbah aspek antara 1:2.5 dengan 2.5:1. Sediakan subjek jelas dan kekalkan butiran penting dalam pemangkasan. Jika tugas memerlukan watak atau produk kekal dapat dikenali, nyatakan ciri yang patut kekal dan periksanya sepanjang klip lengkap.

Bingkai mula dan akhir menetapkan syarat peralihan antara sempadan visual. Aliran kerja bingkai sempadan O1 yang didokumentasikan memerlukan bingkai permulaan apabila bingkai akhir dibekalkan, dan tidak menyokong kawalan bingkai mula/akhir dengan lebih daripada dua imej dalam tatasusunan. Apabila kedua-dua bingkai sempadan digunakan, unsur subjek tambahan bukan sebahagian daripada konfigurasi O1 itu. Asingkan tugas terkawal bingkai daripada penyuntingan video asas yang dibekalkan.

Video sumber boleh mempunyai dua peranan berbeza. Sebagai klip asas, ia ialah rakaman yang disunting: arahkan penambahan, pembuangan, olahan gaya atau perubahan komposisi khusus sambil menyatakan perkara yang patut kekal. Suntingan mengikuti tempoh klip input dan tidak menggabungkan tugas video asas itu dengan kawalan bingkai sempadan atau penjanaan berbilang syot. Sebagai rujukan ciri, video membekalkan maklumat kandungan, gaya atau kamera bagi syot baharu.

Prompt video rujukan turut boleh meminta syot sebelumnya atau berikutnya. Kenal pasti klip sumber dan terangkan peristiwa visual baharu, seperti sambungan tindakan subjek atau pendedahan persekitaran sekeliling. Ini menggunakan rujukan untuk menyampaikan maklumat visual; semak titik sambungan dan kesinambungan subjek sebelum menyusun segmen baharu dengan rakaman asal.

Profil input video pengeluar menerima satu sumber MP4 atau MOV, sehingga 200 MB, dengan tempoh minimum tiga saat. Profil input terperincinya menetapkan dimensi daripada 720 hingga 2160 piksel dan kadar bingkai daripada 24 hingga 60 fps, dengan nisbah aspek input antara 1:2.5 dengan 2.5:1. Aliran kerja video sumber yang didokumentasikan itu memulangkan video 24 fps. Tempoh klip tepat yang dibenarkan turut bergantung pada profil model terpilih. Julat penjanaan baharu O1 ialah tiga hingga sepuluh saat, berbeza daripada julat tempoh 3.0 Omni yang muncul kemudian.

Mod O1 pembuat menyediakan output 720p Standard atau 1080p Pro. Pembingkaian syot baharu menyokong pilihan landskap, potret dan segi empat sama yang didokumentasikan apabila aliran kerja terpilih menggunakan kawalan itu; suntingan video asas mengikuti pembingkaian sumbernya. Audio video sumber boleh dikekalkan atau dibuang. Aliran kerja rujukan dan penyuntingan O1 patut diasingkan daripada profil audio natif dan papan cerita tersuai 3.0 Omni yang muncul kemudian.

Penjanaan menghasilkan tugas yang hasil lengkapnya mengandungi artifak video dan tempoh sebenar. Dokumentasi hasil pembuat menyatakan video janaan dipadam selepas 30 hari, jadi simpan klip lengkap dengan segera. Simpan aset sumber dan taklimat bersama hasil itu, kemudian semak perubahan yang diminta, penggunaan rujukan dan kesinambungan. Untuk suntingan, bandingkan kawasan terjejas dan bahagian yang patut kekal. Untuk syot baharu berpandukan rujukan, periksa bahawa setiap aset membekalkan maklumat visual yang dimaksudkan. Pastikan klip lengkap tersedia untuk suntingan atau urutan produksi berikutnya.

", "aboutText": "Kling VIDEO O1 ialah model video bersepadu Kuaishou yang berpandukan rujukan. Ia menggabungkan penerangan teks dengan imej, unsur subjek yang disediakan atau video sumber untuk membimbing adegan baharu dan perubahan tertumpu pada rakaman sedia ada. Antara muka terasnya ialah taklimat visual: kenal pasti bahan yang dirujuk, terangkan peranannya dan nyatakan rupa, tindakan atau transformasi yang dikehendaki dalam video terhasil.\n\nSyot baharu boleh bermula daripada teks, imej pembukaan atau set rujukan visual. Gunakan imej untuk menetapkan watak atau objek, dan terangkan latar, tindakan serta sudut pandangan dalam kata-kata. Apabila beberapa rujukan menyumbang ciri berbeza, tetapkan peranannya secara jelas. Taklimat produk asal boleh mengambil objek daripada satu imej dan persekitaran daripada imej lain, kemudian menerangkan pergerakan objek dalam latar itu.\n\nPrompt O1 boleh menamakan imej, unsur dan video dengan penanda rujukan tertentu, seperti <<>> atau <<>>. Kekalkan perkaitan penanda itu dengan aset sebenar yang dibekalkan dan jelaskan apa yang patut diambil daripadanya. Had prompt pembuat ialah 2,500 aksara. Arahan ringkas yang mengenal pasti subjek dan perubahan lebih berguna daripada himpunan istilah gaya yang tidak berkaitan.\n\nUntuk rujukan berasaskan imej tanpa input video, had gabungan yang didokumentasikan ialah sehingga tujuh imej rujukan dan unsur berbilang imej. Dengan video rujukan, had imej/unsur itu ialah empat. Had ini terpakai kepada unsur berasaskan imej; jenis unsur lain mempunyai peraturan keserasian berasingan. Pilih bahan yang membekalkan maklumat rupa atau adegan penting, bukannya memenuhi had dengan pandangan berlebihan.\n\nInput imej menggunakan JPG, JPEG atau PNG, dibekalkan sebagai URL boleh dicapai atau data imej, dengan fail sehingga 10 MB, dimensi sekurang-kurangnya 300 piksel dan nisbah aspek antara 1:2.5 dengan 2.5:1. Sediakan subjek jelas dan kekalkan butiran penting dalam pemangkasan. Jika tugas memerlukan watak atau produk kekal dapat dikenali, nyatakan ciri yang patut kekal dan periksanya sepanjang klip lengkap.\n\nBingkai mula dan akhir menetapkan syarat peralihan antara sempadan visual. Aliran kerja bingkai sempadan O1 yang didokumentasikan memerlukan bingkai permulaan apabila bingkai akhir dibekalkan, dan tidak menyokong kawalan bingkai mula/akhir dengan lebih daripada dua imej dalam tatasusunan. Apabila kedua-dua bingkai sempadan digunakan, unsur subjek tambahan bukan sebahagian daripada konfigurasi O1 itu. Asingkan tugas terkawal bingkai daripada penyuntingan video asas yang dibekalkan.\n\nVideo sumber boleh mempunyai dua peranan berbeza. Sebagai klip asas, ia ialah rakaman yang disunting: arahkan penambahan, pembuangan, olahan gaya atau perubahan komposisi khusus sambil menyatakan perkara yang patut kekal. Suntingan mengikuti tempoh klip input dan tidak menggabungkan tugas video asas itu dengan kawalan bingkai sempadan atau penjanaan berbilang syot. Sebagai rujukan ciri, video membekalkan maklumat kandungan, gaya atau kamera bagi syot baharu.\n\nPrompt video rujukan turut boleh meminta syot sebelumnya atau berikutnya. Kenal pasti klip sumber dan terangkan peristiwa visual baharu, seperti sambungan tindakan subjek atau pendedahan persekitaran sekeliling. Ini menggunakan rujukan untuk menyampaikan maklumat visual; semak titik sambungan dan kesinambungan subjek sebelum menyusun segmen baharu dengan rakaman asal.\n\nProfil input video pengeluar menerima satu sumber MP4 atau MOV, sehingga 200 MB, dengan tempoh minimum tiga saat. Profil input terperincinya menetapkan dimensi daripada 720 hingga 2160 piksel dan kadar bingkai daripada 24 hingga 60 fps, dengan nisbah aspek input antara 1:2.5 dengan 2.5:1. Aliran kerja video sumber yang didokumentasikan itu memulangkan video 24 fps. Tempoh klip tepat yang dibenarkan turut bergantung pada profil model terpilih. Julat penjanaan baharu O1 ialah tiga hingga sepuluh saat, berbeza daripada julat tempoh 3.0 Omni yang muncul kemudian.\n\nMod O1 pembuat menyediakan output 720p Standard atau 1080p Pro. Pembingkaian syot baharu menyokong pilihan landskap, potret dan segi empat sama yang didokumentasikan apabila aliran kerja terpilih menggunakan kawalan itu; suntingan video asas mengikuti pembingkaian sumbernya. Audio video sumber boleh dikekalkan atau dibuang. Aliran kerja rujukan dan penyuntingan O1 patut diasingkan daripada profil audio natif dan papan cerita tersuai 3.0 Omni yang muncul kemudian.\n\nPenjanaan menghasilkan tugas yang hasil lengkapnya mengandungi artifak video dan tempoh sebenar. Dokumentasi hasil pembuat menyatakan video janaan dipadam selepas 30 hari, jadi simpan klip lengkap dengan segera. Simpan aset sumber dan taklimat bersama hasil itu, kemudian semak perubahan yang diminta, penggunaan rujukan dan kesinambungan. Untuk suntingan, bandingkan kawasan terjejas dan bahagian yang patut kekal. Untuk syot baharu berpandukan rujukan, periksa bahawa setiap aset membekalkan maklumat visual yang dimaksudkan. Pastikan klip lengkap tersedia untuk suntingan atau urutan produksi berikutnya.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8fd7fdf94b36246ee62c68afbf2b8adaba914bf1e36c5787af9308f32d357535", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ms", "methods": [ { "html": "
•

Kling: Video O1

Kuaishou /kwaivgi/kling-video-o1

Pengenalan

Kling VIDEO O1 ialah model video Kuaishou berpandukan rujukan untuk menjana dan menyunting adegan dengan teks, imej, unsur subjek dan klip sumber. Gunakan profil penjanaan tiga hingga sepuluh saatnya untuk kesinambungan visual, peralihan bingkai berpandukan rujukan dan perubahan tertumpu pada rakaman sedia ada.

Input yang diterima
Teks · Imej
Hasil
Video
Tentang model

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

Kling VIDEO O1 ialah model video bersepadu Kuaishou yang berpandukan rujukan. Ia menggabungkan penerangan teks dengan imej, unsur subjek yang disediakan atau video sumber untuk membimbing adegan baharu dan perubahan tertumpu pada rakaman sedia ada. Antara muka terasnya ialah taklimat visual: kenal pasti bahan yang dirujuk, terangkan peranannya dan nyatakan rupa, tindakan atau transformasi yang dikehendaki dalam video terhasil.

Syot baharu boleh bermula daripada teks, imej pembukaan atau set rujukan visual. Gunakan imej untuk menetapkan watak atau objek, dan terangkan latar, tindakan serta sudut pandangan dalam kata-kata. Apabila beberapa rujukan menyumbang ciri berbeza, tetapkan peranannya secara jelas. Taklimat produk asal boleh mengambil objek daripada satu imej dan persekitaran daripada imej lain, kemudian menerangkan pergerakan objek dalam latar itu.

Prompt O1 boleh menamakan imej, unsur dan video dengan penanda rujukan tertentu, seperti <<<image_1>>> atau <<<video_1>>>. Kekalkan perkaitan penanda itu dengan aset sebenar yang dibekalkan dan jelaskan apa yang patut diambil daripadanya. Had prompt pembuat ialah 2,500 aksara. Arahan ringkas yang mengenal pasti subjek dan perubahan lebih berguna daripada himpunan istilah gaya yang tidak berkaitan.

Untuk rujukan berasaskan imej tanpa input video, had gabungan yang didokumentasikan ialah sehingga tujuh imej rujukan dan unsur berbilang imej. Dengan video rujukan, had imej/unsur itu ialah empat. Had ini terpakai kepada unsur berasaskan imej; jenis unsur lain mempunyai peraturan keserasian berasingan. Pilih bahan yang membekalkan maklumat rupa atau adegan penting, bukannya memenuhi had dengan pandangan berlebihan.

Input imej menggunakan JPG, JPEG atau PNG, dibekalkan sebagai URL boleh dicapai atau data imej, dengan fail sehingga 10 MB, dimensi sekurang-kurangnya 300 piksel dan nisbah aspek antara 1:2.5 dengan 2.5:1. Sediakan subjek jelas dan kekalkan butiran penting dalam pemangkasan. Jika tugas memerlukan watak atau produk kekal dapat dikenali, nyatakan ciri yang patut kekal dan periksanya sepanjang klip lengkap.

Bingkai mula dan akhir menetapkan syarat peralihan antara sempadan visual. Aliran kerja bingkai sempadan O1 yang didokumentasikan memerlukan bingkai permulaan apabila bingkai akhir dibekalkan, dan tidak menyokong kawalan bingkai mula/akhir dengan lebih daripada dua imej dalam tatasusunan. Apabila kedua-dua bingkai sempadan digunakan, unsur subjek tambahan bukan sebahagian daripada konfigurasi O1 itu. Asingkan tugas terkawal bingkai daripada penyuntingan video asas yang dibekalkan.

Video sumber boleh mempunyai dua peranan berbeza. Sebagai klip asas, ia ialah rakaman yang disunting: arahkan penambahan, pembuangan, olahan gaya atau perubahan komposisi khusus sambil menyatakan perkara yang patut kekal. Suntingan mengikuti tempoh klip input dan tidak menggabungkan tugas video asas itu dengan kawalan bingkai sempadan atau penjanaan berbilang syot. Sebagai rujukan ciri, video membekalkan maklumat kandungan, gaya atau kamera bagi syot baharu.

Prompt video rujukan turut boleh meminta syot sebelumnya atau berikutnya. Kenal pasti klip sumber dan terangkan peristiwa visual baharu, seperti sambungan tindakan subjek atau pendedahan persekitaran sekeliling. Ini menggunakan rujukan untuk menyampaikan maklumat visual; semak titik sambungan dan kesinambungan subjek sebelum menyusun segmen baharu dengan rakaman asal.

Profil input video pengeluar menerima satu sumber MP4 atau MOV, sehingga 200 MB, dengan tempoh minimum tiga saat. Profil input terperincinya menetapkan dimensi daripada 720 hingga 2160 piksel dan kadar bingkai daripada 24 hingga 60 fps, dengan nisbah aspek input antara 1:2.5 dengan 2.5:1. Aliran kerja video sumber yang didokumentasikan itu memulangkan video 24 fps. Tempoh klip tepat yang dibenarkan turut bergantung pada profil model terpilih. Julat penjanaan baharu O1 ialah tiga hingga sepuluh saat, berbeza daripada julat tempoh 3.0 Omni yang muncul kemudian.

Mod O1 pembuat menyediakan output 720p Standard atau 1080p Pro. Pembingkaian syot baharu menyokong pilihan landskap, potret dan segi empat sama yang didokumentasikan apabila aliran kerja terpilih menggunakan kawalan itu; suntingan video asas mengikuti pembingkaian sumbernya. Audio video sumber boleh dikekalkan atau dibuang. Aliran kerja rujukan dan penyuntingan O1 patut diasingkan daripada profil audio natif dan papan cerita tersuai 3.0 Omni yang muncul kemudian.

Penjanaan menghasilkan tugas yang hasil lengkapnya mengandungi artifak video dan tempoh sebenar. Dokumentasi hasil pembuat menyatakan video janaan dipadam selepas 30 hari, jadi simpan klip lengkap dengan segera. Simpan aset sumber dan taklimat bersama hasil itu, kemudian semak perubahan yang diminta, penggunaan rujukan dan kesinambungan. Untuk suntingan, bandingkan kawasan terjejas dan bahagian yang patut kekal. Untuk syot baharu berpandukan rujukan, periksa bahawa setiap aset membekalkan maklumat visual yang dimaksudkan. Pastikan klip lengkap tersedia untuk suntingan atau urutan produksi berikutnya.

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Video POST /v1/videos
Input
text, image
Output
video
Format output
bait MP4 asal; tanpa penormalan atau pengekodan semula
MedanJenisKeperluanNilai & hadLalai
MedanmodelJenisstringKeperluanDiperlukanNilai & had
kwaivgi/kling-video-o1
Lalai—
MedanpromptJenisstringKeperluanDiperlukanNilai & hadLalai—
MedandurationJenisintegerKeperluanDiperlukanNilai & had
5, 10
Minimum: 1
Maksimum: 600
Lalai—
MedanresolutionJenisstringKeperluanPilihanNilai & had
720p
Lalai—
Medanaspect_ratioJenisstringKeperluanPilihanNilai & had
16:9, 9:16, 1:1
Lalai—
Medangenerate_audioJenisbooleanKeperluanPilihanNilai & had
false, true
Lalai—
Medanframe_imagesJenisarrayKeperluanPilihanNilai & had
Item minimum: 1
Item maksimum: 2
Kandungan input: Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame atau last_frame. Setiap peranan bingkai boleh muncul paling banyak sekali.
Kunci tepat: type, image_url, frame_type
Syarat: Kunci ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja.
Lalai—
Medaninput_referencesJenisarrayKeperluanPilihanNilai & hadLalai—
MedansizeJenisstringKeperluanPilihanNilai & had
1280x720, 720x1280, 720x720
Corak: ^[1-9][0-9]*x[1-9][0-9]*$
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 sebagai teks dan tempoh dalam saat bulat. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.

model: Jenis: string · kwaivgi/kling-video-o1

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

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

frame_images ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame dengan last_frame pilihan. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.

Kunci tepat: type, image_url, frame_type

model: Jenis: string · kwaivgi/kling-video-o1

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
Parameteradditional_propertiesKontrakfalse
Parameteroptional_controlsKontrakresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Kitar hayat: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Pelan harga

Cara caj akhir dikira

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

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

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

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

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

KonfigurasiJadual kadarKuantiti ramalanUnit pengebilanSyarat pengebilanCaj
KonfigurasiKadar asas tokenJadual kadarKadar asasKuantiti ramalan—Unit pengebilan—Syarat pengebilan—Caj
Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token
Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token
Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token
Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token
Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token
KonfigurasiHarga videoJadual kadar—Kuantiti ramalan—Unit pengebilanbagi setiap saat videoSyarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini.Caj
Output · Harga video · Anggaran untuk perbandingan sahaja $0.224 bagi setiap saat video
KonfigurasiAnggaran kos penjanaanJadual kadar—Kuantiti ramalananggaran untuk satu penjanaanUnit pengebilan—Syarat pengebilan—Caj
Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $1.12 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

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

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

Contoh permintaan

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":5,"model":"kwaivgi/kling-video-o1","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
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 kwaivgi/kling-video-o1

Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

ID pemanggil berkaitan

kwaivgi/kling-video-o1

", "method_identity": { "effective_request_model_id": "kwaivgi/kling-video-o1", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|kwaivgi%2Fkling-video-o1", "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": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Berikan prompt sebagai teks dan tempoh dalam saat bulat. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt bertulis." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame dengan last_frame pilihan. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt bertulis dan imej bingkai pertama." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "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": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "kwaivgi/kling-video-o1" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Kunci ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja.", "content": "Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame atau last_frame. Setiap peranan bingkai boleh muncul paling banyak sekali.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280", "720x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280", "720x720" ], "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, "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": [ "16:9", "9:16", "1:1" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 10 ], "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": false, "maxItems": 0, "type": "array" }, "model": { "const": "kwaivgi/kling-video-o1" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280", "720x720" ], "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." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "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" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Anggaran kos penjanaan", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":5,\"model\":\"kwaivgi/kling-video-o1\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', 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" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "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": "kwaivgi/kling-video-o1", "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.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "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": "kwaivgi/kling-video-o1", "nativeProvenance": { "input_facts_canonical_sha256": "442032431c09c4cac7dbc505ad13287f35d3751e9f4779db812d62e5cdfe7417", "input_html_sha256": "1bfd27eb1aeb4f2af77e863f7567771552204096430bd80f2c33e3b72b671bdf", "private_audit_sha256": "48127e0410b0a09df837d0ab5f12d729d3fc93ad028b700aadf0920b7ba03b37", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ms/kwaivgi-kling-video-o1/", "description": "Kling VIDEO O1 ialah model video Kuaishou berpandukan rujukan untuk menjana dan menyunting adegan dengan teks, imej, unsur subjek dan klip sumber. Gunakan profil penjanaan tiga hingga sepuluh saatnya untuk kesinambungan visual, peralihan bingkai berpandukan rujukan dan perubahan tertumpu pada rakaman sedia ada.", "locale": "ms", "md_url": "https://ailoot.ai/models/ms/kwaivgi-kling-video-o1/index.md", "title": "Kling: Video O1 — Ailoot", "url": "https://ailoot.ai/models/ms/kwaivgi-kling-video-o1/" }, "rawModel": { "about": "Kling VIDEO O1 ialah model video bersepadu Kuaishou yang berpandukan rujukan. Ia menggabungkan penerangan teks dengan imej, unsur subjek yang disediakan atau video sumber untuk membimbing adegan baharu dan perubahan tertumpu pada rakaman sedia ada. Antara muka terasnya ialah taklimat visual: kenal pasti bahan yang dirujuk, terangkan peranannya dan nyatakan rupa, tindakan atau transformasi yang dikehendaki dalam video terhasil.\n\nSyot baharu boleh bermula daripada teks, imej pembukaan atau set rujukan visual. Gunakan imej untuk menetapkan watak atau objek, dan terangkan latar, tindakan serta sudut pandangan dalam kata-kata. Apabila beberapa rujukan menyumbang ciri berbeza, tetapkan peranannya secara jelas. Taklimat produk asal boleh mengambil objek daripada satu imej dan persekitaran daripada imej lain, kemudian menerangkan pergerakan objek dalam latar itu.\n\nPrompt O1 boleh menamakan imej, unsur dan video dengan penanda rujukan tertentu, seperti <<>> atau <<>>. Kekalkan perkaitan penanda itu dengan aset sebenar yang dibekalkan dan jelaskan apa yang patut diambil daripadanya. Had prompt pembuat ialah 2,500 aksara. Arahan ringkas yang mengenal pasti subjek dan perubahan lebih berguna daripada himpunan istilah gaya yang tidak berkaitan.\n\nUntuk rujukan berasaskan imej tanpa input video, had gabungan yang didokumentasikan ialah sehingga tujuh imej rujukan dan unsur berbilang imej. Dengan video rujukan, had imej/unsur itu ialah empat. Had ini terpakai kepada unsur berasaskan imej; jenis unsur lain mempunyai peraturan keserasian berasingan. Pilih bahan yang membekalkan maklumat rupa atau adegan penting, bukannya memenuhi had dengan pandangan berlebihan.\n\nInput imej menggunakan JPG, JPEG atau PNG, dibekalkan sebagai URL boleh dicapai atau data imej, dengan fail sehingga 10 MB, dimensi sekurang-kurangnya 300 piksel dan nisbah aspek antara 1:2.5 dengan 2.5:1. Sediakan subjek jelas dan kekalkan butiran penting dalam pemangkasan. Jika tugas memerlukan watak atau produk kekal dapat dikenali, nyatakan ciri yang patut kekal dan periksanya sepanjang klip lengkap.\n\nBingkai mula dan akhir menetapkan syarat peralihan antara sempadan visual. Aliran kerja bingkai sempadan O1 yang didokumentasikan memerlukan bingkai permulaan apabila bingkai akhir dibekalkan, dan tidak menyokong kawalan bingkai mula/akhir dengan lebih daripada dua imej dalam tatasusunan. Apabila kedua-dua bingkai sempadan digunakan, unsur subjek tambahan bukan sebahagian daripada konfigurasi O1 itu. Asingkan tugas terkawal bingkai daripada penyuntingan video asas yang dibekalkan.\n\nVideo sumber boleh mempunyai dua peranan berbeza. Sebagai klip asas, ia ialah rakaman yang disunting: arahkan penambahan, pembuangan, olahan gaya atau perubahan komposisi khusus sambil menyatakan perkara yang patut kekal. Suntingan mengikuti tempoh klip input dan tidak menggabungkan tugas video asas itu dengan kawalan bingkai sempadan atau penjanaan berbilang syot. Sebagai rujukan ciri, video membekalkan maklumat kandungan, gaya atau kamera bagi syot baharu.\n\nPrompt video rujukan turut boleh meminta syot sebelumnya atau berikutnya. Kenal pasti klip sumber dan terangkan peristiwa visual baharu, seperti sambungan tindakan subjek atau pendedahan persekitaran sekeliling. Ini menggunakan rujukan untuk menyampaikan maklumat visual; semak titik sambungan dan kesinambungan subjek sebelum menyusun segmen baharu dengan rakaman asal.\n\nProfil input video pengeluar menerima satu sumber MP4 atau MOV, sehingga 200 MB, dengan tempoh minimum tiga saat. Profil input terperincinya menetapkan dimensi daripada 720 hingga 2160 piksel dan kadar bingkai daripada 24 hingga 60 fps, dengan nisbah aspek input antara 1:2.5 dengan 2.5:1. Aliran kerja video sumber yang didokumentasikan itu memulangkan video 24 fps. Tempoh klip tepat yang dibenarkan turut bergantung pada profil model terpilih. Julat penjanaan baharu O1 ialah tiga hingga sepuluh saat, berbeza daripada julat tempoh 3.0 Omni yang muncul kemudian.\n\nMod O1 pembuat menyediakan output 720p Standard atau 1080p Pro. Pembingkaian syot baharu menyokong pilihan landskap, potret dan segi empat sama yang didokumentasikan apabila aliran kerja terpilih menggunakan kawalan itu; suntingan video asas mengikuti pembingkaian sumbernya. Audio video sumber boleh dikekalkan atau dibuang. Aliran kerja rujukan dan penyuntingan O1 patut diasingkan daripada profil audio natif dan papan cerita tersuai 3.0 Omni yang muncul kemudian.\n\nPenjanaan menghasilkan tugas yang hasil lengkapnya mengandungi artifak video dan tempoh sebenar. Dokumentasi hasil pembuat menyatakan video janaan dipadam selepas 30 hari, jadi simpan klip lengkap dengan segera. Simpan aset sumber dan taklimat bersama hasil itu, kemudian semak perubahan yang diminta, penggunaan rujukan dan kesinambungan. Untuk suntingan, bandingkan kawasan terjejas dan bahagian yang patut kekal. Untuk syot baharu berpandukan rujukan, periksa bahawa setiap aset membekalkan maklumat visual yang dimaksudkan. Pastikan klip lengkap tersedia untuk suntingan atau urutan produksi berikutnya.", "alias_of": null, "aliases": [], "author": "Kuaishou", "available": null, "canonical_model": "kwaivgi/kling-video-o1", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "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": "5674106f0bbce742cc7b0c00", "label": "Rujukan harga konfigurasi video", "profiles": [ { "basis": "Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan.", "dimensions": { "conditions": "Tiada syarat tambahan dinyatakan dalam kunci harga ini." }, "label": "Harga video", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "kwaivgi/kling-video-o1", "input": [ "text", "image" ], "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": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Berikan prompt sebagai teks dan tempoh dalam saat bulat. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt bertulis." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame dengan last_frame pilihan. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Pilih resolusi yang disokong; tambah nisbah bidang atau gunakan saiz yang disenaraikan.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt bertulis dan imej bingkai pertama." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "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": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "kwaivgi/kling-video-o1" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Kunci ini menerangkan setiap objek bingkai; image_url hanya mengandungi url. Gugurkan frame_images untuk permintaan teks sahaja.", "content": "Tatasusunan objek bingkai. Setiap objek mempunyai type=image_url, image_url yang mengandungi url dan frame_type. Gunakan URL imej HTTPS dan tetapkan frame_type kepada first_frame atau last_frame. Setiap peranan bingkai boleh muncul paling banyak sekali.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280", "720x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280", "720x720" ], "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, "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": [ "16:9", "9:16", "1:1" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 10 ], "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": false, "maxItems": 0, "type": "array" }, "model": { "const": "kwaivgi/kling-video-o1" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280", "720x720" ], "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." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "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" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Anggaran kos penjanaan", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":5,\"model\":\"kwaivgi/kling-video-o1\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', 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" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "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": "kwaivgi/kling-video-o1", "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.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "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": "kwaivgi/kling-video-o1", "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra" } ], "name": "Kling: Video O1", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.12, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.12, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "hosted_reference" }, "dimensions": { "published_labels": [], "variant": "duration_seconds" }, "label": "Ultra", "units": [ { "amount": "0.2240", "amount_unit": "usd_per_second", "conditions": { "published_labels": [], "variant": "duration_seconds" }, "key": "duration_seconds", "label": "duration seconds", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.224", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.2240", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "kwaivgi/kling-video-o1", "short": "Kling VIDEO O1 ialah model video Kuaishou berpandukan rujukan untuk menjana dan menyunting adegan dengan teks, imej, unsur subjek dan klip sumber. Gunakan profil penjanaan tiga hingga sepuluh saatnya untuk kesinambungan visual, peralihan bingkai berpandukan rujukan dan perubahan tertumpu pada rakaman sedia ada." }, "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": "Kling VIDEO O1 ialah model video Kuaishou berpandukan rujukan untuk menjana dan menyunting adegan dengan teks, imej, unsur subjek dan klip sumber. Gunakan profil penjanaan tiga hingga sepuluh saatnya untuk kesinambungan visual, peralihan bingkai berpandukan rujukan dan perubahan tertumpu pada rakaman sedia ada.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "3da6d20dfd520f0bffc7e0ae4d0e84176094ebfc6aff2c70b418634ae9247072", "renderer_sha256": "1dab5ba62521e9568c8b7c82005622cabbf330a075df7cce1f83274a04009460" }, "sourceRevision": "90d5d3ae93cea8ba99cf4ef13ea1eaf492bb011bfdf176ecf78edf0d4d9a3a78" }