# Kling 3.0 Turbo API

Kuaishou의 Kling 3.0 Turbo 비디오 생성 모델에 대한 전체 API 레퍼런스입니다.

## 모델 변형

이 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 |
|---------|---------------|----------------|
| 입력 | 텍스트 프롬프트 | 이미지 + 텍스트 프롬프트 |
| 길이 범위 | 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 | 비디오 생성 프롬프트 |
| `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`.

## 모범 사례

- 프롬프트는 모션, 카메라 움직임, 장면 분위기에 집중하세요.
- 이미지-비디오의 경우 주제가 명확한 깔끔한 첫 프레임 이미지를 사용하세요.
- 빠른 반복에는 더 짧은 길이를 사용한 뒤, 최종 렌더링에서는 길이를 늘리세요.