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 - Kling v3 (direkomendasikan)
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 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
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 akan terjadi error
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 pembuatan gambar-ke-video
  • Berikan 1 gambar: digunakan sebagai bingkai pertama
  • Berikan 2 gambar: secara otomatis ditetapkan sebagai bingkai pertama + bingkai terakhir
Maksimum 2 gambar didukungContoh: ["https://example.com/first.jpg"]
  • Maksimum 2 gambar yang didukung
  • URL gambar harus dapat diakses publik tanpa proteksi hotlink
  • Dalam mode gambar-ke-video, aspect_ratio dapat ditimpa oleh rasio gambar aktual
boolean
Apakah menambahkan watermark
boolean
default:"false"
Apakah membuat video dengan audio
boolean
default:"false"
Apakah mengaktifkan mode multi-shot.
  • true
  • false
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 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 duration tingkat atas
Format:
Wajib saat multi_shot=true dan shot_type=customize.
array<object>
Daftar subjek referensi, hingga 3 subjek.
  • Buat secara langsung melalui name, description, element_input_urls
Contoh:
Catatan:
  • name, description, dan element_input_urls wajib untuk pembuatan secara langsung
  • element_input_urls: 2-4 gambar per subjek (yang pertama sebagai gambar frontal, sisanya sebagai referensi)
  • Rujuk elemen dalam prompt dengan @name, misalnya "@element_dog chasing @element_cat on grass"

Kendala Parameter

  • mode=4k didukung untuk kling-v3
  • image_urls mendukung hingga 2 gambar (1 bingkai pertama, 2 bingkai pertama+terakhir)
  • Input hanya bingkai terakhir tidak valid (harus menyertakan bingkai pertama)
  • Saat multi_shot=true, prompt tingkat atas dapat dihilangkan
  • multi_prompt mendukung hingga 6 shot, dan index harus dimulai dari 1 dan berurutan

Matriks Dukungan Fitur

Teks-ke-Video vs Gambar-ke-Video

Sistem otomatis menentukan mode berdasarkan apakah image_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.