# API Kling 3.0 Turbo

Referência completa da API para modelos de geração de vídeo Kling 3.0 Turbo da Kuaishou.

## Variantes do modelo

Esta API oferece suporte a duas variantes de modelo:

| Modelo | ID | Descrição |
|-------|-----|-------------|
| **Kling 3.0 Turbo Text to Video** | `kling-3.0-turbo-text-to-video` | Geração rápida de texto para vídeo |
| **Kling 3.0 Turbo Image to Video** | `kling-3.0-turbo-image-to-video` | Animação rápida de imagem para vídeo |

## Comparação rápida

| Recurso | Text to Video | Image to Video |
|---------|---------------|----------------|
| Entrada | Prompt de texto | Imagem + prompt de texto |
| Intervalo de duração | 3-15 segundos | 3-15 segundos |
| Opções de resolução | 720p, 1080p | 720p, 1080p |
| Proporções | 16:9, 9:16, 1:1 | Não compatível (guiado pela origem) |
| Quadro inicial | Não compatível | Obrigatório |

### Proporções compatíveis (Text to Video)

| Proporção | Descrição |
|-------|-------------|
| `16:9` | Paisagem (widescreen) |
| `9:16` | Retrato (vertical) |
| `1:1` | Quadrado |

## Kling 3.0 Turbo Text to Video

### Ponto de conexão

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

### Parâmetros da solicitação

#### Obrigatórios

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `model_name` | string | Deve ser `"kling-3.0-turbo-text-to-video"` |
| `prompt` | string | Prompt de geração de vídeo |
| `resolution` | string | Resolução de saída: `"720p"` ou `"1080p"` |
| `duration` | number | Duração do vídeo em segundos (3-15) |

#### Opcionais

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `aspect_ratio` | string | Proporção do vídeo: `"16:9"`, `"9:16"` ou `"1:1"`. O padrão é `"16:9"` |
| `sound` | boolean | Gera som ambiente para o vídeo |

### Solicitação de exemplo

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

### Parâmetros da solicitação

#### Obrigatórios

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `model_name` | string | Deve ser `"kling-3.0-turbo-image-to-video"` |
| `prompt` | string | Prompt de movimento e cena |
| `image_url` | string | URL da imagem do primeiro quadro |
| `resolution` | string | Resolução de saída: `"720p"` ou `"1080p"` |
| `duration` | number | Duração do vídeo em segundos (3-15) |

#### Opcionais

| Parâmetro | Tipo | Descrição |
|-----------|------|-------------|
| `sound` | boolean | Gera som ambiente para o vídeo |

### Solicitação de exemplo

```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
}
```

## Formato da resposta

Resposta de envio:

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

Consulte com `GET /api/v1/video/{task_id}`. Status da tarefa: `submitted`, `processing`, `succeed`, `failed`.

## Boas práticas

- Mantenha os prompts focados em movimento, comportamento da câmera e atmosfera da cena.
- Para image-to-video, use uma imagem limpa do primeiro quadro com um assunto claro.
- Use durações mais curtas para iteração mais rápida e depois aumente a duração para renderizações finais.