Kling: Video O1
Kling VIDEO O1 adalah model video berbasis referensi Kuaishou untuk menghasilkan dan menyunting adegan dengan teks, gambar, elemen subjek, dan klip sumber. Gunakan profil generasi tiga hingga sepuluh detiknya untuk kesinambungan visual, transisi bingkai berpanduan, dan perubahan terarah pada rekaman yang ada.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Kling VIDEO O1 adalah model video terpadu berbasis referensi dari Kuaishou. Model ini menggabungkan deskripsi teks dengan gambar, elemen subjek yang disiapkan, atau video sumber untuk memandu adegan baru serta perubahan terarah pada rekaman yang ada. Antarmuka intinya adalah arahan visual: identifikasi materi yang dirujuk, jelaskan perannya, dan nyatakan penampilan, tindakan, atau transformasi yang Anda inginkan pada video hasilnya.
Shot baru dapat dimulai dari teks, gambar pembuka, atau kumpulan referensi visual. Gunakan gambar untuk menentukan karakter atau objek, lalu jelaskan latar, tindakan, dan sudut pandang dengan kata-kata. Ketika beberapa referensi menyumbangkan ciri berbeda, tetapkan perannya secara eksplisit. Arahan produk orisinal dapat mengambil objek dari satu gambar dan lingkungan dari gambar lain, lalu menjelaskan gerakan objek dalam latar itu.
Prompt O1 dapat menyebut gambar, elemen, dan video melalui penanda referensi khusus, seperti <<<image_1>>> atau <<<video_1>>>. Pertahankan kaitan penanda tersebut dengan aset yang benar-benar diberikan dan jelaskan apa yang harus diambil darinya. Batas prompt pembuatnya adalah 2.500 karakter. Instruksi ringkas yang mengidentifikasi subjek serta perubahan lebih berguna daripada kumpulan istilah gaya yang tidak berkaitan.
Untuk referensi berbasis gambar tanpa masukan video, anggaran gabungan yang didokumentasikan adalah hingga tujuh gambar referensi dan elemen banyak gambar. Dengan video referensi, anggaran gambar/elemen itu adalah empat. Batas ini berlaku untuk elemen berbasis gambar; jenis elemen lain memiliki aturan kompatibilitas terpisah. Pilih materi yang menyediakan informasi penampilan atau adegan penting, alih-alih memenuhi anggaran dengan tampilan berulang.
Masukan gambar menggunakan JPG, JPEG, atau PNG, diberikan sebagai URL yang dapat diakses atau data gambar, dengan berkas hingga 10 MB, dimensi paling sedikit 300 piksel, dan rasio aspek antara 1:2,5 dan 2,5:1. Siapkan subjek yang jelas dan pertahankan detail penting dalam pemangkasan. Jika tugas memerlukan karakter atau produk tetap dapat dikenali, nyatakan ciri yang harus tetap ada dan periksa di sepanjang klip lengkap.
Bingkai awal dan akhir mengondisikan transisi antara batas visual. Alur kerja bingkai batas O1 yang didokumentasikan mewajibkan bingkai awal ketika bingkai akhir diberikan dan tidak mendukung kendali bingkai awal/akhir dengan lebih dari dua gambar dalam larik. Ketika kedua bingkai batas digunakan, elemen subjek tambahan bukan bagian konfigurasi O1 tersebut. Pisahkan tugas yang dikendalikan bingkai dari penyuntingan video dasar yang diberikan.
Video sumber dapat memiliki dua peran berbeda. Sebagai klip dasar, video adalah rekaman yang disunting: arahkan penambahan, penghapusan, perlakuan gaya, atau perubahan komposisi tertentu sambil menyatakan apa yang harus tetap ada. Suntingan mengikuti durasi klip masukan dan tidak menggabungkan tugas video dasar itu dengan kendali bingkai batas atau generasi banyak shot. Sebagai referensi ciri, video menyediakan informasi konten, gaya, atau kamera bagi shot baru.
Prompt video referensi juga dapat meminta shot sebelum atau sesudahnya. Identifikasi klip sumber dan jelaskan peristiwa visual baru, seperti kelanjutan tindakan subjek atau pengungkapan lingkungan sekitarnya. Ini menggunakan referensi untuk menyampaikan informasi visual; tinjau sambungan dan kesinambungan subjek sebelum merangkai segmen baru dengan rekaman asli.
Profil masukan video produsen menerima satu sumber MP4 atau MOV, hingga 200 MB, dengan durasi minimum tiga detik. Profil masukan terperincinya menetapkan dimensi dari 720 hingga 2160 piksel dan laju bingkai dari 24 hingga 60 fps, dengan rasio aspek masukan antara 1:2,5 dan 2,5:1. Alur kerja video sumber yang didokumentasikan itu mengembalikan video 24 fps. Durasi klip yang tepat yang diizinkan juga bergantung pada profil model pilihan. Rentang generasi baru O1 adalah tiga hingga sepuluh detik, berbeda dari rentang durasi 3.0 Omni berikutnya.
Mode O1 pembuatnya menyediakan keluaran 720p Standard atau 1080p Pro. Pembingkaian shot baru mendukung pilihan lanskap, potret, dan persegi yang didokumentasikan ketika alur kerja pilihan menggunakan kendali itu; suntingan video dasar mengikuti pembingkaian sumbernya. Audio video sumber dapat dipertahankan atau dibuang. Alur kerja referensi serta penyuntingan O1 perlu tetap terpisah dari profil audio bawaan dan storyboard kustom 3.0 Omni berikutnya.
Generasi menghasilkan tugas yang hasil lengkapnya berisi artefak video dan durasi sebenarnya. Dokumentasi hasil pembuatnya menyatakan bahwa video hasil generasi dihapus setelah 30 hari, jadi segera simpan klip lengkap. Simpan aset sumber dan arahan bersama hasil itu, lalu tinjau perubahan yang diminta, penggunaan referensi, serta kesinambungan. Untuk suntingan, bandingkan area terdampak dan bagian yang harus tetap ada. Untuk shot baru berbasis referensi, periksa bahwa setiap aset menyediakan informasi visual yang dimaksud. Simpan klip lengkap agar tersedia untuk suntingan atau urutan produksi berikutnya.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Mulai
Kling VIDEO O1 adalah model video berbasis referensi Kuaishou untuk menghasilkan dan menyunting adegan dengan teks, gambar, elemen subjek, dan klip sumber. Gunakan profil generasi tiga hingga sepuluh detiknya untuk kesinambungan visual, transisi bingkai berpanduan, dan perubahan terarah pada rekaman yang ada.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Video POST /v1/videos
- Masukan
text,image- Keluaran
video- Format keluaran
- byte MP4 asli; tanpa normalisasi atau pengodean ulang
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan kwaivgi/kling-video-o1 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanWajib | Nilai & batasan 5, 10 Minimum: 1 Maksimum: 600 | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 720p | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 9:16, 1:1 | Bawaan— |
Kolomgenerate_audio | Jenisboolean | PersyaratanOpsional | Nilai & batasan false, true | Bawaan— |
Kolomframe_images | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 1 Item maksimum: 2 Konten masukan: Array objek bingkai. Setiap objek memiliki type=image_url, image_url yang memuat url, dan frame_type. Gunakan URL gambar HTTPS dan tetapkan frame_type ke first_frame atau last_frame. Setiap peran bingkai muncul paling banyak sekali. Kunci persis: type, image_url, frame_type Kondisi: Kunci-kunci ini menjelaskan setiap objek bingkai; image_url hanya memuat url. Hilangkan frame_images untuk permintaan yang hanya berisi teks. | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomsize | Jenisstring | PersyaratanOpsional | Nilai & batasan 1280x720, 720x1280, 720x720 Pola: ^[1-9][0-9]*x[1-9][0-9]*$ | Bawaan— |
Kolomcallback_url | Jenisstring | PersyaratanOpsional | Nilai & batasan Pola: ^https:// | Bawaan— |
Kolomsession_id | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomtrace | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomuser | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kombinasi bahan masukan
Teks ke video · Prompt tertulis. · Wajib: model, prompt, duration
Berikan prompt sebagai teks dan durasi dalam detik bulat. Pilih resolusi yang didukung; tambahkan rasio aspek atau gunakan ukuran yang tercantum.
model: Jenis: string · kwaivgi/kling-video-o1
prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya
Gambar ke video · Prompt tertulis dan satu gambar bingkai pertama. · Wajib: model, prompt, duration, frame_images
frame_images berupa array. Setiap objek bingkai memiliki type, image_url, dan frame_type; image_url memuat url. Tetapkan type ke image_url. Gunakan first_frame dengan last_frame opsional. Setiap peran bingkai muncul paling banyak sekali. Berikan URL gambar HTTPS publik untuk setiap bingkai. Pilih resolusi yang didukung; tambahkan rasio aspek atau gunakan ukuran yang tercantum.
Kunci persis: type, image_url, frame_type
model: Jenis: string · kwaivgi/kling-video-o1
prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya
Parameter metode dan siklus hidup
| 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 |
Siklus hidup: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Kondisi penagihan | Biaya |
|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan penagihan— | Kondisi penagihan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanTidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini. | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.224 per detik video |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Kondisi penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $1.12 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Detail tarif referensi
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
Referensi harga konfigurasi video
Harga menurut konfigurasi
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiHarga video | Kondisi penagihanTidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini. | Biaya Keluaran · Harga video $0.224 per detik video Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan. |
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
URL konten bertanda tangan milik Ailoot
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Periksa 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 konten 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 berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan setiap keluaran aktual milik Ailoot beserta metadata hasil pengukuran yang dikembalikan.
Jika respons asli perlu diperiksa
503 result_pending_check + id asli + X-Should-Retry:false; jangan pernah ulangi pengiriman awal
Kolom respons
| Kolom | Jenis | Arti |
|---|---|---|
Kolomindex | Jenisinteger | ArtiPosisi video ini dalam daftar keluaran, dihitung dari nol. |
Kolomcontent_url | Jenisstring | ArtiURL unduhan HTTPS bertanda tangan untuk video yang telah selesai ini. |
Kolomsha256 | Jenisstring | null | ArtiDigest SHA-256 dari byte video asli; null jika tidak tersedia. |
Kolomsize_bytes | Jenisinteger | null | ArtiUkuran berkas video asli dalam byte; null jika tidak tersedia. |
Kolomduration_ms | Jenisinteger | null | ArtiDurasi video terukur dalam milidetik; null jika tidak tersedia. |
Kolomwidth | Jenisinteger | null | ArtiLebar video dalam piksel; null jika tidak tersedia. |
Kolomheight | Jenisinteger | null | ArtiTinggi video dalam piksel; null jika tidak tersedia. |
Kolomvideo_codec | Jenisstring | null | ArtiPengenal codec video; null jika tidak dicatat. |
Kolomhas_audio | Jenisboolean | null | ArtiApakah video memuat trek audio; null jika tidak diukur. |
Kolomaudio_codec | Jenisstring | null | ArtiPengenal codec audio; null jika tidak ada pengenal yang dicatat. |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons404 · not_found_error | KondisiAkses video tidak tersedia, atau ID video ini tidak ditemukan. | Langkah berikutnyaPeriksa akses video. Untuk video yang sudah ada, gunakan ID publik aslinya dan kunci API yang sama. |
Respons401 · authentication_error | KondisiKunci API tidak cocok dengan akun yang diautentikasi. | Langkah berikutnyaPeriksa kunci API dan akses akun Anda sebelum mengirim. |
Respons400 · invalid_request_error | KondisiPermintaan tidak dapat dibaca, atau indeks unduhan tidak valid. | Langkah berikutnyaPerbaiki isi permintaan. Untuk unduhan, pilih indeks keluaran yang dikembalikan oleh tugas awal. |
Respons422 · price_unavailable | KondisiHarga konfigurasi video yang dipilih tidak dapat dihitung. | Langkah berikutnyaPilih konfigurasi video yang didukung dan lengkapi opsi wajibnya sebelum mengirim permintaan yang telah diperbaiki. |
Respons422 · invalid_request_error | KondisiMasukan video atau tugas kelanjutan awal tidak valid. | Langkah berikutnyaGunakan masukan HTTPS yang valid. Untuk kelanjutan, gunakan ID video publik awal Anda yang telah selesai dengan kunci API yang sama. |
Respons402 · billing_error | KondisiSaldo atau batas yang tersedia tidak memungkinkan pencadangan dana. | Langkah berikutnyaPeriksa saldo dan batas yang tersedia sebelum mengirim permintaan baru. |
Respons503 · server_error | KondisiVerifikasi video, penyimpanan, atau akses layanan sementara tidak tersedia. | Langkah berikutnyaTunggu hingga layanan tersedia. Jika Anda sudah memiliki ID video, periksa tugas awal tersebut alih-alih memulai pembuatan baru. |
Respons503 · result_pending_check | KondisiHasil video awal dan tagihannya perlu diperiksa. | Langkah berikutnyaSimpan ID video yang dikembalikan dan periksa tugas tersebut. Jangan kirim permintaan pembuatan pengganti selama tugas itu sedang diperiksa. |
Respons503 · owned_result_unavailable | KondisiUnduhan video yang sudah ada sementara tidak tersedia. | Langkah berikutnyaPeriksa tugas video yang sama nanti dan unduh keluaran yang sudah ada. Pembuatan baru menghasilkan operasi terpisah. |
Respons409 · video_not_ready | KondisiKonten video belum dipublikasikan. | Langkah berikutnyaPeriksa status tugas awal. Unduh setelah statusnya completed; jika statusnya failed, ikuti pemberitahuan pemeriksaan tagihannya. |
Alias
Alias model
Ailoot Ultra kwaivgi/kling-video-o1
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Kling: Video O1
- Input dan hasil apa yang tersedia?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Kolom apa yang digunakan 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- Batasan apa yang berlaku?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1