Kling 3.0 Motion Control API

Referensi API lengkap untuk pembuatan video Kling 3.0 Motion Control dari Kuaishou.

Varian Model

API ini mendukung satu varian model:

Model	ID	Deskripsi
Kling 3.0 Motion Control	`kling-3.0-motion-control`	Pembuatan video menggunakan prompt teks, satu gambar referensi, dan satu video referensi

Kling 3.0 Motion Control

Titik Akhir

POST /api/v1/video/task

Parameter Permintaan

Wajib

Parameter	Tipe	Deskripsi
`model_name`	string	Harus berupa `"kling-3.0-motion-control"`
`prompt`	string	Prompt pembuatan video, maksimal 5000 karakter
`images`	string[]	Tepat satu URL gambar referensi. Mendukung `.jpg`, `.jpeg`, dan `.png`; ukuran file tidak boleh melebihi 50 MB. Lebar dan tinggi masing-masing minimal 300 px, dengan rasio aspek gambar antara 1:2.5 dan 2.5:1
`videos`	string[]	Tepat satu URL video referensi. Mendukung `.mp4` dan `.mov`; ukuran file tidak boleh melebihi 100 MB. Lebar dan tinggi masing-masing harus antara 340 hingga 3850 px, termasuk kedua batas tersebut. Durasi minimal 3 detik; durasi maksimal bergantung pada `character_orientation`
`character_orientation`	string	Wajib tanpa nilai default. `"image"`: mengikuti orientasi karakter dalam gambar referensi; durasi video referensi harus 3-10 detik. `"video"`: mengikuti orientasi karakter dalam video referensi; durasi video referensi harus 3-30 detik. Kedua rentang durasi mencakup batas bawah dan batas atas
`resolution`	string	Resolusi keluaran: `"720p"` atau `"1080p"`. Wajib tanpa nilai default

Opsional

Parameter	Tipe	Deskripsi
`keep_original_sound`	boolean	Menentukan apakah suara asli video referensi dipertahankan. Menerima `true` atau `false`; nilai default adalah `true`

Durasi keluaran mengikuti video sumber. Parameter duration tidak didukung. Rasio aspek keluaran ditentukan oleh media masukan, dan aspect_ratio tidak didukung. Penyedia hulu belum menentukan masukan mana yang menentukan rasio aspek keluaran atau aturan pemilihan yang pasti.

Biaya dihitung berdasarkan durasi video sumber yang dibulatkan ke detik bulat terdekat dan resolusi keluaran yang dipilih. Misalnya, 5.4 detik ditagih sebagai 5 detik, sedangkan 5.5 detik sebagai 6 detik.

Contoh Permintaan

Ganti URL media contoh dengan URL file Anda sendiri yang memenuhi persyaratan di atas.

javascript
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-3.0-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Format Respons

Respons Awal

Mengembalikan task_id untuk polling:

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Lakukan polling dengan GET /api/v1/video/{task_id} untuk memeriksa status dan mengambil video yang dihasilkan.

Nilai Status

submitted: Tugas diterima dan menunggu untuk diproses
processing: Pembuatan video sedang berlangsung
succeed: Pembuatan video selesai
failed: Pembuatan video gagal

Praktik Terbaik

Media Referensi: Sediakan tepat satu gambar dan satu video, serta periksa format, ukuran file, dan dimensinya sebelum mengirim
Orientasi: Periksa kembali durasi video referensi saat mengubah character_orientation, terutama saat memilih "image"
Suara Asli: Atur keep_original_sound ke false agar suara asli video referensi tidak dipertahankan; jika parameter ini tidak disertakan, suara akan dipertahankan