Skip to main content
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-omni - Kling v3 Omni (antarmuka terpadu)
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Prompt teks positifMendukung referensi gambar dari image_urls menggunakan sintaks <<<image_N>>>, dengan N dimulai dari 1.Contoh: "Make the person in <<<image_1>>> wave at the camera"
Jika gambar diberikan tetapi prompt tidak berisi referensi <<<image_N>>>, sistem akan otomatis menambahkan <<<image_1>>> di awal prompt.
string
Prompt negatif digunakan untuk mengecualikan konten yang tidak diinginkan. Panjang maksimum 2500 karakter.
string
default:"std"
Mode pembuatanOpsi:
  • std - Mode standar (720P)
  • pro - Mode profesional (1080P)
  • 4k - Mode 4K ultra HD
Default: std
integer
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 error akan terjadi
string
default:"16:9"
Rasio aspek videoOpsi:
  • 16:9 - Lanskap
  • 9:16 - Potret
  • 1:1 - Persegi
Default: 16:9
array<url>
Array URL gambar untuk referensi gambarReferensikan gambar yang sesuai dalam prompt menggunakan sintaks <<<image_N>>> (N dimulai dari 1)Contoh: ["https://example.com/photo.jpg"]
  • URL gambar harus dapat diakses publik tanpa proteksi hotlink
  • Dalam mode gambar-ke-video, aspect_ratio dapat ditimpa oleh rasio gambar aktual
array<object>
Array gambar berbasis peran, direkomendasikan untuk gambar-ke-video.Format setiap item: { "url": "...", "role": "..." }
  • first_frame: frame pertama
  • last_frame: frame terakhir
  • reference: gambar referensi
image_urls dan image_with_roles saling eksklusif. Gunakan hanya salah satu.
array
Daftar video referensi (berbasis URL), hingga 1 video.Gunakan refer_type untuk membedakan jenis:
  • base: video yang akan diedit (default)
  • feature: video referensi fitur
Gunakan keep_original_sound untuk mengontrol audio asli:
  • no: jangan pertahankan (default)
  • yes: pertahankan suara asli
Format permintaan:
  • video_url tidak boleh kosong, dan URL video harus dapat diakses
  • Saat refer_type=base:
    • Frame awal/akhir tidak dapat ditentukan
    • Video referensi harus 3-10 detik
    • Durasi video yang dibuat mengikuti video yang diunggah
  • Saat refer_type=feature dan video_url tidak kosong:
    • image_urls hanya dapat berisi gambar frame pertama
  • Persyaratan video: hanya MP4/MOV; durasi minimal 3 detik; resolusi 720px-2160px; frame rate 24-60fps (output 24fps); ukuran tidak lebih dari 200MB
boolean
default:"false"
Apakah mengaktifkan mode multi-shot.
string
Metode pemisahan shot: customize / intelligence.Wajib saat multi_shot=true.
array<object>
Daftar multi-shot, setiap item adalah { index, prompt, duration }.
  • Minimum 1 shot, maksimum 6 shot
  • duration setiap shot harus berupa integer dan >= 1
  • Jumlah durasi semua shot harus sama dengan duration di level atas
  • index harus dimulai dari 1 dan meningkat berkesinambungan
  • Wajib saat multi_shot=true dan shot_type=customize
Contoh:
array<object>
Daftar subjek referensi, hingga 3 subjek. Mendukung:
  • Membuat subjek secara langsung dengan name, description, element_input_urls
Format umum:
Catatan:
  • Untuk pembuatan langsung, name, description, element_input_urls wajib
  • element_input_urls: 2 hingga 4 gambar per subjek (yang pertama sebagai gambar frontal, lainnya sebagai referensi)
  • Gunakan @name di prompt, misalnya "@element_dog dan @element_cat are playing on the grass"
boolean
Apakah menambahkan watermark
boolean
default:"false"
Apakah membuat video dengan audio
Parameter ini saling eksklusif dengan video_list.Saat video_list memiliki nilai, parameter audio tidak diperlukan.

Kendala dan Batas Parameter

  • image_urls dan image_with_roles saling eksklusif
  • mode=4k tersedia untuk kling-v3-omni
  • Input hanya frame terakhir (last_frame tanpa frame pertama) tidak valid
  • Frame awal/akhir dan edit video saling eksklusif: saat video_list.refer_type=base (atau dihilangkan), frame awal/akhir tidak diizinkan
  • Saat video_list ada, audio diabaikan
  • video_list mendukung paling banyak 1 video
  • multi_prompt mendukung hingga 6 shot, dengan index dimulai dari 1 dan meningkat berkesinambungan

Sintaks Referensi Gambar

Model Omni menggunakan sintaks <<<image_N>>> untuk merujuk gambar dalam prompt, memberikan pengalaman teks-ke-video/gambar-ke-video yang terpadu:
Referensi Otomatis: Jika image_urls disediakan tetapi prompt tidak berisi referensi <<<image_N>>>, sistem akan otomatis menambahkan <<<image_1>>> di awal prompt.

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Kasus Penggunaan

Kasus 1: Teks-ke-Video (Mode Standar)

Kasus 2: Referensi Gambar (Satu Gambar)

Kasus 3: Beberapa Referensi Gambar

Kasus 4: Gambar Diberikan Tanpa Referensi Eksplisit (Ditambahkan Otomatis)

Sistem akan otomatis menambahkan <<<image_1>>> di awal prompt, setara dengan "<<<image_1>>>The person slowly turns and smiles".

Kasus 5: Membuat Video dengan Audio

Catatan: audio saling eksklusif dengan video_list. Saat video_list memiliki nilai, parameter audio tidak diperlukan.
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.