> ## 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 Video Generation

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

* 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 Image API](/en/api-reference/uploads/images) first.
</Warning>

## Authorization

<ParamField header="Authorization" type="string" required>
  All endpoints require Bearer Token authentication.

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## Request Parameters

<ParamField body="model" type="string" required>
  Video generation model name, fixed as `kling-3.0-turbo`.
</ParamField>

<ParamField body="prompt" type="string" required>
  Text prompt. For image-to-video, this is sent to Kling Turbo as the `prompt` content item.
</ParamField>

<ParamField body="reference_images" type="string[]">
  Optional 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.
  </Warning>
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Video resolution.

  Supported values:

  * `720p`
  * `1080p`
</ParamField>

<ParamField body="duration" type="integer" default="5">
  Video duration in seconds.

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

<ParamField body="aspect_ratio" type="string" default="16:9">
  Video aspect ratio for text-to-video.

  Supported values:

  * `16:9`
  * `9:16`
  * `1:1`
</ParamField>

<ParamField body="watermark" type="boolean" default="false">
  Whether to add the official Kling watermark.
</ParamField>

## 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 Status](/en/api-reference/tasks/video-status) endpoint to query progress and results.
</Note>