# 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

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