# API Kling 2.6 Motion Control

Tài liệu tham khảo API đầy đủ cho tính năng tạo video bằng Kling 2.6 Motion Control của Kuaishou.

## Các biến thể mô hình

API này hỗ trợ một biến thể mô hình:

| Mô hình | ID | Mô tả |
|-------|-----|-------------|
| **Kling 2.6 Motion Control** | `kling-2.6-motion-control` | Tạo video bằng câu lệnh văn bản, một hình ảnh tham chiếu và một video tham chiếu |

## Kling 2.6 Motion Control

### Điểm cuối

```
POST /api/v1/video/task
```

### Tham số yêu cầu

#### Bắt buộc

| Tham số | Kiểu | Mô tả |
|-----------|------|-------------|
| `model_name` | string | Phải là `"kling-2.6-motion-control"` |
| `prompt` | string | Câu lệnh tạo video, tối đa 5000 ký tự |
| `images` | string[] | Chính xác một URL hình ảnh tham chiếu. Hỗ trợ `.jpg`, `.jpeg` và `.png`; kích thước tệp không được vượt quá 50 MB. Chiều rộng và chiều cao đều phải đạt ít nhất 300 px, với tỷ lệ khung hình của ảnh trong khoảng từ 1:2.5 đến 2.5:1 |
| `videos` | string[] | Chính xác một URL video tham chiếu. Hỗ trợ `.mp4` và `.mov`; kích thước tệp không được vượt quá 100 MB. Chiều rộng và chiều cao đều phải nằm trong khoảng từ 340 đến 3850 px, bao gồm cả hai giới hạn. Thời lượng phải đạt ít nhất 3 giây; mức tối đa phụ thuộc vào `character_orientation` |
| `character_orientation` | string | Bắt buộc, không có giá trị mặc định. `"image"`: theo hướng của nhân vật trong hình ảnh tham chiếu; video tham chiếu phải dài 3-10 giây. `"video"`: theo hướng của nhân vật trong video tham chiếu; video tham chiếu phải dài 3-30 giây. Cả hai khoảng thời lượng đều bao gồm các giá trị giới hạn |
| `resolution` | string | Độ phân giải đầu ra: `"720p"` hoặc `"1080p"`. Bắt buộc, không có giá trị mặc định |

#### Tùy chọn

| Tham số | Kiểu | Mô tả |
|-----------|------|-------------|
| `keep_original_sound` | boolean | Có giữ lại âm thanh gốc của video tham chiếu hay không. Chấp nhận `true` hoặc `false`; mặc định là `true` |

Thời lượng đầu ra theo video nguồn. Không hỗ trợ tham số `duration`. Tỷ lệ khung hình đầu ra do nội dung đa phương tiện đầu vào quyết định và không hỗ trợ `aspect_ratio`. Nhà cung cấp thượng nguồn chưa nêu rõ đầu vào nào quyết định tỷ lệ khung hình đầu ra hoặc quy tắc lựa chọn cụ thể.

Chi phí được tính dựa trên thời lượng video nguồn làm tròn đến số giây nguyên gần nhất và độ phân giải đầu ra đã chọn. Ví dụ, 5.4 giây được tính phí là 5 giây, còn 5.5 giây là 6 giây.

### Yêu cầu mẫu

Thay các URL nội dung đa phương tiện mẫu bằng URL tệp của bạn đáp ứng các yêu cầu ở trên.

```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-2.6-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;
```

## Định dạng phản hồi

### Phản hồi ban đầu

Trả về `task_id` để truy vấn định kỳ:

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

Truy vấn định kỳ bằng `GET /api/v1/video/{task_id}` để kiểm tra trạng thái và lấy video đã tạo.

### Các giá trị trạng thái

- `submitted`: Tác vụ đã được chấp nhận và đang chờ xử lý
- `processing`: Đang tạo video
- `succeed`: Đã hoàn tất tạo video
- `failed`: Tạo video thất bại

## Các phương pháp hay nhất

1. **Nội dung đa phương tiện tham chiếu**: Cung cấp chính xác một hình ảnh và một video, đồng thời kiểm tra định dạng, kích thước tệp và kích thước khung hình trước khi gửi
2. **Hướng nhân vật**: Kiểm tra lại thời lượng video tham chiếu khi thay đổi `character_orientation`, đặc biệt khi chọn `"image"`
3. **Âm thanh gốc**: Đặt `keep_original_sound` thành `false` để không giữ lại âm thanh gốc của video tham chiếu; nếu bỏ qua tham số này, âm thanh sẽ được giữ lại