# API Kling 3.0 Turbo

เอกสารอ้างอิง API ฉบับสมบูรณ์สำหรับโมเดลสร้างวิดีโอ Kling 3.0 Turbo โดย Kuaishou

## รุ่นย่อยของโมเดล

API นี้รองรับโมเดลสองรุ่นย่อย:

| โมเดล | ID | คำอธิบาย |
|-------|-----|-------------|
| **Kling 3.0 Turbo Text to Video** | `kling-3.0-turbo-text-to-video` | การสร้างข้อความเป็นวิดีโออย่างรวดเร็ว |
| **Kling 3.0 Turbo Image to Video** | `kling-3.0-turbo-image-to-video` | การสร้างแอนิเมชันจากรูปภาพเป็นวิดีโออย่างรวดเร็ว |

## การเปรียบเทียบอย่างรวดเร็ว

| ฟีเจอร์ | Text to Video | Image to Video |
|---------|---------------|----------------|
| อินพุต | prompt ข้อความ | รูปภาพ + prompt ข้อความ |
| ช่วงระยะเวลา | 3-15 วินาที | 3-15 วินาที |
| ตัวเลือกความละเอียด | 720p, 1080p | 720p, 1080p |
| อัตราส่วนภาพ | 16:9, 9:16, 1:1 | ไม่รองรับ (ขับเคลื่อนตามแหล่งที่มา) |
| เฟรมเริ่มต้น | ไม่รองรับ | จำเป็น |

### อัตราส่วนภาพที่รองรับ (Text to Video)

| อัตราส่วน | คำอธิบาย |
|-------|-------------|
| `16:9` | แนวนอน (จอกว้าง) |
| `9:16` | แนวตั้ง |
| `1:1` | สี่เหลี่ยมจัตุรัส |

## Kling 3.0 Turbo Text to Video

### จุดปลายทาง

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

### พารามิเตอร์คำขอ

#### จำเป็น

| พารามิเตอร์ | ประเภท | คำอธิบาย |
|-----------|------|-------------|
| `model_name` | string | ต้องเป็น `"kling-3.0-turbo-text-to-video"` |
| `prompt` | string | prompt สำหรับสร้างวิดีโอ |
| `resolution` | string | ความละเอียดเอาต์พุต: `"720p"` หรือ `"1080p"` |
| `duration` | number | ระยะเวลาวิดีโอเป็นวินาที (3-15) |

#### ไม่บังคับ

| พารามิเตอร์ | ประเภท | คำอธิบาย |
|-----------|------|-------------|
| `aspect_ratio` | string | อัตราส่วนภาพวิดีโอ: `"16:9"`, `"9:16"` หรือ `"1:1"` ค่าเริ่มต้นคือ `"16:9"` |
| `sound` | boolean | สร้างเสียงบรรยากาศสำหรับวิดีโอ |

### ตัวอย่างคำขอ

```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-turbo-text-to-video',
    prompt: 'A girl sits on a train, looking out the window with a melancholic expression, cinematic lighting',
    aspect_ratio: '16:9',
    resolution: '720p',
    duration: 5,
    sound: true
  })
});

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

## Kling 3.0 Turbo Image to Video

### พารามิเตอร์คำขอ

#### จำเป็น

| พารามิเตอร์ | ประเภท | คำอธิบาย |
|-----------|------|-------------|
| `model_name` | string | ต้องเป็น `"kling-3.0-turbo-image-to-video"` |
| `prompt` | string | prompt สำหรับการเคลื่อนไหวและฉาก |
| `image_url` | string | URL รูปภาพเฟรมแรก |
| `resolution` | string | ความละเอียดเอาต์พุต: `"720p"` หรือ `"1080p"` |
| `duration` | number | ระยะเวลาวิดีโอเป็นวินาที (3-15) |

#### ไม่บังคับ

| พารามิเตอร์ | ประเภท | คำอธิบาย |
|-----------|------|-------------|
| `sound` | boolean | สร้างเสียงบรรยากาศสำหรับวิดีโอ |

### ตัวอย่างคำขอ

```javascript
{
  model_name: 'kling-3.0-turbo-image-to-video',
  prompt: 'The character slowly turns her head and looks out the window, subtle camera movement',
  image_url: 'https://example.com/test-first-frame.png',
  resolution: '720p',
  duration: 5,
  sound: true
}
```

## รูปแบบการตอบกลับ

การตอบกลับเมื่อส่ง:

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

Polling ด้วย `GET /api/v1/video/{task_id}` สถานะงาน: `submitted`, `processing`, `succeed`, `failed`

## แนวทางปฏิบัติที่ดีที่สุด

- ให้ prompt โฟกัสที่การเคลื่อนไหว พฤติกรรมกล้อง และบรรยากาศของฉาก
- สำหรับ image-to-video ให้ใช้รูปภาพเฟรมแรกที่สะอาดและมีตัวแบบชัดเจน
- ใช้ระยะเวลาที่สั้นลงเพื่อการทดลองซ้ำที่เร็วขึ้น แล้วค่อยเพิ่มระยะเวลาสำหรับการ render ขั้นสุดท้าย