> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# kling-3.0-turbo 비디오 생성

> Generate videos with the official kling-3.0-turbo model through the standard ToAPIs async video endpoint

> [!NOTE]
>
> **중국 본토 사용자 안내:** 중국 본토 사용자는 `https://toapis.cn` 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 `https://toapis.com` 을 `https://toapis.cn` 로 바꿔 주세요.

* Async task API, returns a task ID after submission
* Uses the new official Kling Turbo upstream protocol
* Supports text-to-video and image-to-video with first-frame input only
* `resolution` supports `720p` and `1080p`
* `duration` supports `3s`, `4s`, `5s`, `6s`, `7s`, `8s`, `9s`, `10s`, `11s`, `12s`, `13s`, `14s`, `15s`
* `aspect_ratio` applies to text-to-video requests
* `watermark` is a boolean toggle only; custom watermark payloads are not supported

> [!WARNING]
>
> Use publicly accessible image URLs. Do not pass base64 image data. Upload local images with the [Upload 이미지 API](https://docs.toapis.com/docs/ko/api-reference/uploads/images.md) first.

## Authorization

**Authorization** `string` *required*

All endpoints require Bearer Token authentication.

```
Authorization: Bearer YOUR_API_KEY
```

## 요청 파라미터

**model** `string` *required*

Video generation model name, fixed as `kling-3.0-turbo`.

**prompt** `string` *required*

Text prompt. For image-to-video, this is sent to Kling Turbo as the `prompt` content item.

**reference\_images** `string[]`

선택 input images. For Kling Turbo image-to-video, only the first image is used as `first_frame`.

> [!WARNING]
>
> Tail frame input is not supported in this integration. Additional input images are ignored.

**resolution** `string` (default: 720p)

Video resolution.

Supported values:

* `720p`
* `1080p`

**duration** `integer` (default: 5)

Video duration in seconds.

Supported values: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`

**aspect\_ratio** `string` (default: 16:9)

Video aspect ratio for text-to-video.

Supported values:

* `16:9`
* `9:16`
* `1:1`

**watermark** `boolean` (default: false)

Whether to add the official Kling watermark.

## Examples

### Text-to-Video

```json theme={null}
{
  "model": "kling-3.0-turbo",
  "prompt": "A cinematic shot of a red sports car driving through rain",
  "resolution": "720p",
  "duration": 5,
  "aspect_ratio": "16:9"
}
```

### Image-to-Video

```json theme={null}
{
  "model": "kling-3.0-turbo",
  "prompt": "Animate the character with subtle camera motion",
  "reference_images": ["https://example.com/first-frame.png"],
  "resolution": "1080p",
  "duration": 5,
  "watermark": true
}
```

> [!NOTE]
>
> Video generation is asynchronous. Use the [Get Video Task 상태](https://docs.toapis.com/docs/ko/api-reference/tasks/video-status.md) endpoint to query progress and results.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.