Kling v3
Pembuatan Video Kling v3
- Mode pemrosesan asinkron, mengembalikan ID tugas untuk kueri berikutnya
- Mendukung teks-ke-video, gambar-ke-video (kontrol frame pertama/frame pertama-terakhir)
- Mendukung mode standar (720P), mode profesional (1080P), dan mode 4K
- Mendukung durasi video 3 hingga 15 detik
- Mendukung pembuatan video dengan audio
POST
Otorisasi
string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header request:
Parameter Request
string
wajib
Nama model pembuatan videoModel yang didukung:
kling-v3- Kling v3 (direkomendasikan)
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
true: periksa prompt dan gambar input denganomni-moderation-latestfalseatau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Prompt teksJelaskan adegan, aksi, dan gaya secara detail untuk hasil pembuatan yang lebih baik. Prompt bahasa Inggris direkomendasikan.Contoh:
"a golden retriever running on the beach, sunset, cinematic"string
Prompt negatif untuk mengecualikan konten yang tidak diinginkanContoh:
"blurry, low quality, distorted"string
default:"std"
Mode pembuatanOpsi:
std- Mode standar (720P)pro- Mode profesional (1080P)4k- Mode 4K
stdinteger
default:"5"
Default:
5
Durasi video (detik)Rentang: 3-15 (minimum 3 detik, maksimum 15 detik)⚠️ Catatan: Harus berupa angka biasa (misalnya 6), jangan tambahkan tanda kutip, jika tidak akan terjadi errorstring
default:"16:9"
Rasio aspek videoOpsi:
16:9- Lanskap9:16- Potret1:1- Persegi
16:9array<url>
Array URL gambar untuk pembuatan gambar-ke-video
- Berikan 1 gambar: digunakan sebagai bingkai pertama
- Berikan 2 gambar: secara otomatis ditetapkan sebagai bingkai pertama + bingkai terakhir
["https://example.com/first.jpg"]boolean
Apakah menambahkan watermark
boolean
default:"false"
Apakah membuat video dengan audio
boolean
default:"false"
Apakah mengaktifkan mode multi-shot.
truefalse
string
Metode pemisahan shot:
customize / intelligence.Wajib saat multi_shot=true.array<object>
Informasi per shot, seperti prompt dan durasi.Tentukan urutan shot, prompt, dan durasi melalui Wajib saat
index, prompt, dan duration.- Mendukung 1 hingga 6 shot
- Panjang konten maksimum per shot adalah 512
- Setiap durasi shot harus >= 1 dan tidak boleh melebihi total durasi tugas
- Jumlah semua durasi shot harus sama dengan
durationtingkat atas
multi_shot=true dan shot_type=customize.array<object>
Daftar subjek referensi, hingga 3 subjek.Catatan:
- Buat secara langsung melalui
name,description,element_input_urls
name,description, danelement_input_urlswajib untuk pembuatan secara langsungelement_input_urls: 2-4 gambar per subjek (yang pertama sebagai gambar frontal, sisanya sebagai referensi)- Rujuk elemen dalam
promptdengan@name, misalnya"@element_dog chasing @element_cat on grass"
Kendala Parameter
mode=4kdidukung untukkling-v3image_urlsmendukung hingga 2 gambar (1 bingkai pertama, 2 bingkai pertama+terakhir)- Input hanya bingkai terakhir tidak valid (harus menyertakan bingkai pertama)
- Saat
multi_shot=true,prompttingkat atas dapat dihilangkan multi_promptmendukung hingga 6 shot, danindexharus dimulai dari 1 dan berurutan
Matriks Dukungan Fitur
Teks-ke-Video vs Gambar-ke-Video
Sistem otomatis menentukan mode berdasarkan apakahimage_urls disediakan: tanpa gambar berarti teks-ke-video, dengan gambar berarti gambar-ke-video.
Respons
integer
Kode status respons, 200 jika berhasil
array
Array data respons
Kasus Penggunaan
Kasus 1: Teks-ke-Video (Mode Standar)
Kasus 2: Teks-ke-Video (Mode Pro + Prompt Negatif)
Kasus 3: Teks-ke-Video (15 detik)
Kasus 4: Gambar-ke-Video (Frame Pertama)
Kasus 5: Gambar-ke-Video (Kontrol Frame Pertama + Terakhir)
Kasus 6: Membuat Video dengan Audio
Kasus 7: Storyboard Multi-Shot (customize, 15 detik, potret dengan audio)
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan
task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.