# Kling 3.0 Turbo API

Полный справочник 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` | Быстрая анимация изображения в видео |

## Краткое сравнение

| Функция | Текст в видео | Изображение в видео |
|---------|---------------|----------------|
| Входные данные | Текстовый промпт | Изображение + текстовый промпт |
| Диапазон длительности | 3-15 секунд | 3-15 секунд |
| Варианты разрешения | 720p, 1080p | 720p, 1080p |
| Соотношения сторон | 16:9, 9:16, 1:1 | Не поддерживается (определяется источником) |
| Начальный кадр | Не поддерживается | Обязательно |

### Поддерживаемые соотношения сторон (текст в видео)

| Соотношение | Описание |
|-------|-------------|
| `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 | Промпт для генерации видео |
| `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 | Промпт для движения и сцены |
| `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"
  }
}
```

Опросите с помощью `GET /api/v1/video/{task_id}`. Статусы задачи: `submitted`, `processing`, `succeed`, `failed`.

## Лучшие практики

- Держите промпты сосредоточенными на движении, поведении камеры и атмосфере сцены.
- Для image-to-video используйте чистое изображение первого кадра с четким объектом.
- Используйте меньшую длительность для более быстрой итерации, затем увеличивайте длительность для финальных рендеров.