Kling: Video O1
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.
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.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Pengenalan
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
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
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had kwaivgi/kling-video-o1 | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanduration | Jenisinteger | KeperluanDiperlukan | Nilai & had 5, 10 Minimum: 1 Maksimum: 600 | Lalai— |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 720p | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 9:16, 1:1 | Lalai— |
Medangenerate_audio | Jenisboolean | KeperluanPilihan | Nilai & had false, true | Lalai— |
Medanframe_images | Jenisarray | KeperluanPilihan | Nilai & 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_references | Jenisarray | KeperluanPilihan | Nilai & had | Lalai— |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had 1280x720, 720x1280, 720x720 Corak: ^[1-9][0-9]*x[1-9][0-9]*$ | Lalai— |
Medancallback_url | Jenisstring | KeperluanPilihan | Nilai & had Corak: ^https:// | Lalai— |
Medansession_id | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medantrace | Jenisobject | KeperluanPilihan | Nilai & had | Lalai— |
Medanuser | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
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
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, duration |
Parametermaterial_types | Kontraktext, image |
Parameteradditional_properties | Kontrakfalse |
Parameteroptional_controls | Kontrakresolution, 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.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Unit pengebilan | Syarat pengebilan | Caj |
|---|---|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti 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 video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanTiada syarat tambahan dinyatakan dalam kunci harga ini. | Caj Output · Harga video · Anggaran untuk perbandingan sahaja $0.224 bagi setiap saat video |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit 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
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiHarga video | Syarat 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('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')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Pembacaan kandungan lain
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
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')
target=Path('owned-'+label+'.bin')
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)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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
| Medan | Jenis | Maksud |
|---|---|---|
Medanindex | Jenisinteger | MaksudKedudukan video ini dalam senarai output dengan indeks bermula dari sifar. |
Medancontent_url | Jenisstring | MaksudURL muat turun HTTPS bertandatangan untuk video siap ini. |
Medansha256 | Jenisstring | null | MaksudRingkasan SHA-256 bagi bait video asal; null jika tidak tersedia. |
Medansize_bytes | Jenisinteger | null | MaksudSaiz fail video asal dalam bait; null jika tidak tersedia. |
Medanduration_ms | Jenisinteger | null | MaksudTempoh video yang diukur dalam milisaat; null jika tidak tersedia. |
Medanwidth | Jenisinteger | null | MaksudLebar video dalam piksel; null jika tidak tersedia. |
Medanheight | Jenisinteger | null | MaksudKetinggian video dalam piksel; null jika tidak tersedia. |
Medanvideo_codec | Jenisstring | null | MaksudPengecam codec video; null jika tidak direkodkan. |
Medanhas_audio | Jenisboolean | null | MaksudSama ada video mengandungi trek audio; null jika tidak diukur. |
Medanaudio_codec | Jenisstring | null | MaksudPengecam codec audio; null apabila tiada pengecam direkodkan. |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons404 · not_found_error | SyaratAkses 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_error | SyaratKunci API tidak sepadan dengan akaun yang disahkan. | Langkah seterusnyaSemak kunci API dan akses akaun anda sebelum menghantar. |
Respons400 · invalid_request_error | SyaratPermintaan 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_unavailable | SyaratHarga 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_error | SyaratInput 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_error | SyaratBaki atau had yang tersedia tidak membenarkan penahanan dana. | Langkah seterusnyaSemak baki dan had yang tersedia sebelum menghantar permintaan baharu. |
Respons503 · server_error | SyaratPengesahan 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_check | SyaratHasil 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_unavailable | SyaratMuat 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_ready | SyaratKandungan 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
FAQ · Kling: Video O1
- Apakah input dan hasil yang tersedia?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·kwaivgi/kling-video-o1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Apakah had yang terpakai?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1