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-video-o1 - Kling Video O1 (penalaran ditingkatkan, kualitas tertinggi)
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 positifPrompt tidak boleh melebihi 2.500 karakter.Mendukung 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
default:"std"
Mode pembuatanOpsi:
  • std - Mode standar (720P)
  • pro - Mode profesional (1080P)
Default: std
integer
default:"5"
Durasi video (detik)Opsi: 5 atau 10Default: 5
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.png"]
  • URL gambar harus dapat diakses publik tanpa proteksi hotlink
  • Dalam mode gambar-ke-video, aspect_ratio dapat ditimpa oleh rasio gambar aktual
  • Hingga dua gambar. Item pertama dalam array adalah frame awal, dan item kedua adalah frame akhir
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, jangan kirim keduanya sekaligus.
  • Jika lebih dari 2 gambar dikirim, pengaturan frame awal/akhir tidak didukung.
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 apakah audio asli dipertahankan:
  • no: jangan pertahankan (default)
  • yes: pertahankan suara asli
Format request:
  • 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

Sintaks Referensi Gambar

Model Video O1 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>>> apa pun, 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 (Kualitas Tertinggi)

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".
Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.