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

# Kling 3.0 Turbo API

> Generate AI videos fast with Kling 3.0 Turbo. Text-to-video and image-to-video with dedicated 720p and 1080p generate endpoints, 3-15 second durations, and 16:9, 9:16, or 1:1 aspect ratios.

<Card title="Kling 3.0 Turbo integration" icon="video">
  Kling 3.0 Turbo is the fast generation model from the Kling 3.0 family, delivering smooth motion and high visual fidelity with shorter processing times for rapid iteration.
</Card>

Kling 3.0 Turbo is an AI video generation API optimized for speed. It produces high-fidelity videos from a text prompt (text-to-video) or from a single image (image-to-video), with durations from 3 to 15 seconds. As part of the Kling 3.0 family, Turbo prioritizes faster generation, making it well suited for high-volume workflows and quick creative iteration.

Resolution is selected at generation time: each mode has a dedicated **720p** generate endpoint and a dedicated **1080p** generate endpoint. Task status and listing are handled by a single generic endpoint per mode, regardless of the resolution used to create the task.

### Key capabilities

* **Dual input modes**: Generate video from a text prompt (t2v) or animate a first-frame image (i2v)
* **Resolution by generate endpoint**: Dedicated `720p` (standard high definition) and `1080p` (full high definition) generate endpoints per mode
* **Unified task tracking**: One generic list endpoint and one generic status endpoint per mode, for tasks of any resolution
* **Fast generation**: Turbo-optimized pipeline for shorter processing times than standard Kling 3.0 models
* **Flexible durations**: Any whole number from 3 to 15 seconds, default `5`
* **Aspect ratios (t2v)**: `16:9` landscape, `9:16` portrait, and `1:1` square
* **Prompt control**: Up to 3072 characters in text-to-video, up to 2500 characters of motion guidance in image-to-video
* **Async processing**: Webhook notifications or polling for task completion
* **24-hour delivery**: Generated MP4 video is returned via a URL valid for 24 hours

### Use cases

* **Social media content**: Produce vertical `9:16` clips for TikTok, Instagram Reels, and YouTube Shorts
* **Marketing videos**: Animate product images or generate brand content from prompts at scale
* **Rapid prototyping**: Iterate quickly on creative concepts thanks to fast Turbo generation
* **Concept visualization**: Turn static designs into motion for pitches and previews
* **Ad variations**: Generate multiple resolutions, aspect ratios, and durations from a single concept

### Generation modes

| Mode                     | Input                                          | Resolution                          | Aspect ratio control        | Best for                                          |
| ------------------------ | ---------------------------------------------- | ----------------------------------- | --------------------------- | ------------------------------------------------- |
| **Text-to-Video (t2v)**  | Text prompt (required)                         | `720p` or `1080p` generate endpoint | `16:9`, `9:16`, `1:1`       | Creating videos from scratch, concept exploration |
| **Image-to-Video (i2v)** | First-frame image (required) + optional prompt | `720p` or `1080p` generate endpoint | Inherited from source image | Animating existing images and product shots       |

## API Operations

### Text-to-Video (t2v)

Generate a video from a text description using the 720p or 1080p endpoint, then track it with the generic list and status endpoints. Generation returns a task ID for async polling or webhook notification.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-video/kling-v3-turbo-720p" icon="video" href="/api-reference/text-to-video/kling-v3-turbo/generate-720p">
      Generate a 720p video from a text prompt
    </Card>

    <Card title="POST /v1/ai/text-to-video/kling-v3-turbo-1080p" icon="video" href="/api-reference/text-to-video/kling-v3-turbo/generate-1080p">
      Generate a 1080p video from a text prompt
    </Card>

    <Card title="GET /v1/ai/text-to-video/kling-v3-turbo" icon="list" href="/api-reference/text-to-video/kling-v3-turbo/tasks">
      List all Kling 3.0 Turbo T2V tasks (any resolution)
    </Card>

    <Card title="GET /v1/ai/text-to-video/kling-v3-turbo/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-video/kling-v3-turbo/task-by-id">
      Get T2V task status and result by ID
    </Card>
  </Columns>
</div>

### Image-to-Video (i2v)

Animate a first-frame image using the 720p or 1080p endpoint, then track it with the generic list and status endpoints. Generation returns a task ID for async polling or webhook notification.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/image-to-video/kling-v3-turbo-720p" icon="video" href="/api-reference/image-to-video/kling-v3-turbo/generate-720p">
      Generate a 720p video from a first-frame image
    </Card>

    <Card title="POST /v1/ai/image-to-video/kling-v3-turbo-1080p" icon="video" href="/api-reference/image-to-video/kling-v3-turbo/generate-1080p">
      Generate a 1080p video from a first-frame image
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v3-turbo" icon="list" href="/api-reference/image-to-video/kling-v3-turbo/tasks">
      List all Kling 3.0 Turbo I2V tasks (any resolution)
    </Card>

    <Card title="GET /v1/ai/image-to-video/kling-v3-turbo/{task-id}" icon="magnifying-glass" href="/api-reference/image-to-video/kling-v3-turbo/task-by-id">
      Get I2V task status and result by ID
    </Card>
  </Columns>
</div>

### Endpoint structure

| Operation          | Text-to-Video                                       | Image-to-Video                                       |
| ------------------ | --------------------------------------------------- | ---------------------------------------------------- |
| **Generate 720p**  | `POST /v1/ai/text-to-video/kling-v3-turbo-720p`     | `POST /v1/ai/image-to-video/kling-v3-turbo-720p`     |
| **Generate 1080p** | `POST /v1/ai/text-to-video/kling-v3-turbo-1080p`    | `POST /v1/ai/image-to-video/kling-v3-turbo-1080p`    |
| **List tasks**     | `GET /v1/ai/text-to-video/kling-v3-turbo`           | `GET /v1/ai/image-to-video/kling-v3-turbo`           |
| **Get task**       | `GET /v1/ai/text-to-video/kling-v3-turbo/{task-id}` | `GET /v1/ai/image-to-video/kling-v3-turbo/{task-id}` |

### Parameters

Resolution is determined by the generate endpoint you call (`-720p` or `-1080p`) and is not a body parameter.

#### Text-to-Video

| Parameter      | Type     | Required | Default | Description                                                                  |
| -------------- | -------- | -------- | ------- | ---------------------------------------------------------------------------- |
| `prompt`       | `string` | Yes      | -       | Text description of the video. 1-3072 characters (2500 or fewer recommended) |
| `aspect_ratio` | `string` | No       | `16:9`  | Output ratio: `16:9` (landscape), `9:16` (portrait), `1:1` (square)          |
| `duration`     | `string` | No       | `5`     | Video length in seconds, any whole number from `3` to `15`                   |
| `webhook_url`  | `string` | No       | -       | URL for async status notifications                                           |

#### Image-to-Video

| Parameter     | Type     | Required | Default | Description                                                                                                                 |
| ------------- | -------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `image`       | `string` | Yes      | -       | First-frame image as a public URL or Base64 string. JPG, JPEG, or PNG; min 300x300px; max 50MB; aspect ratio 1:2.5 to 2.5:1 |
| `prompt`      | `string` | No       | -       | Motion and style guidance. Up to 2500 characters. If omitted, motion is inferred from the image                             |
| `duration`    | `string` | No       | `5`     | Video length in seconds, any whole number from `3` to `15`                                                                  |
| `webhook_url` | `string` | No       | -       | URL for async status notifications                                                                                          |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Kling 3.0 Turbo and how does it work?">
    Kling 3.0 Turbo is the fast-generation model in the Kling 3.0 family. You submit a text prompt (text-to-video) or a first-frame image (image-to-video) to a resolution-specific generate endpoint and receive a task ID immediately. Poll the generic GET status endpoint or supply a `webhook_url` to be notified when the task completes, then download the MP4 video from the returned URL (valid for 24 hours).
  </Accordion>

  <Accordion title="How do I choose 720p or 1080p?">
    Resolution is selected by the generate endpoint, not by a body parameter. Call the `-720p` endpoint for standard high definition or the `-1080p` endpoint for full high definition. Task listing and status use a single generic endpoint per mode, regardless of the resolution.
  </Accordion>

  <Accordion title="Do I need different endpoints to check task status by resolution?">
    No. Status and listing are generic per mode: `GET /v1/ai/text-to-video/kling-v3-turbo` (and `/{task-id}`) covers all text-to-video tasks, and `GET /v1/ai/image-to-video/kling-v3-turbo` (and `/{task-id}`) covers all image-to-video tasks, whether they were generated at 720p or 1080p.
  </Accordion>

  <Accordion title="What is the difference between text-to-video and image-to-video?">
    Text-to-video generates a video purely from a text prompt and lets you choose the aspect ratio (`16:9`, `9:16`, or `1:1`). Image-to-video animates a first-frame image you provide; the aspect ratio is inherited from that image and the prompt is optional, used only to guide motion and style.
  </Accordion>

  <Accordion title="What video durations does Kling 3.0 Turbo support?">
    Kling 3.0 Turbo supports any whole-number duration from 3 to 15 seconds (default `5`). Shorter durations generate faster.
  </Accordion>

  <Accordion title="What aspect ratios are available?">
    Text-to-video supports `16:9` (landscape), `9:16` (portrait), and `1:1` (square). Image-to-video does not accept an aspect ratio parameter; the output ratio is inherited from the source image.
  </Accordion>

  <Accordion title="What image formats and sizes are supported for image-to-video?">
    Image-to-video accepts JPG, JPEG, and PNG, provided as a publicly accessible URL or a Base64-encoded string (without the data URI prefix). Requirements: minimum 300x300 pixels, maximum 50MB, and an aspect ratio between 1:2.5 and 2.5:1. Only the first frame is supported.
  </Accordion>

  <Accordion title="How long does generation take and how do I get the result?">
    Generation time depends on resolution and duration, but Turbo is optimized for faster processing than standard Kling 3.0 models. Poll the GET task endpoint or provide a `webhook_url` to be notified on completion. The result MP4 is delivered via a URL that remains valid for 24 hours.
  </Accordion>

  <Accordion title="What are the rate limits for Kling 3.0 Turbo?">
    Rate limits depend on your subscription tier. See the [Rate Limits](/ratelimits) page for current limits by plan.
  </Accordion>

  <Accordion title="How much does Kling 3.0 Turbo cost?">
    Pricing varies by resolution and duration. See the [Pricing](/pricing) page for current rates and credit costs.
  </Accordion>
</AccordionGroup>

## Best practices

* **Resolution choice**: Use the `-720p` generate endpoint for faster generation and the `-1080p` generate endpoint when you need maximum detail
* **Prompt writing**: Be specific about the scene, subjects, motion, camera movement, lighting, and visual style for better results
* **Negative descriptions inline**: Steer the model away from artifacts by adding phrases like "no text, no blur" directly in the prompt
* **Image selection (i2v)**: Use clear, high-resolution images within the 300x300px to 50MB range and the 1:2.5 to 2.5:1 aspect ratio bounds
* **Duration selection**: Start at 3-5 seconds for fast iterations, then increase up to 15 seconds for final outputs
* **Production integration**: Use webhooks instead of polling for scalable applications
* **Result retrieval**: Download the output promptly, as the delivery URL is valid for 24 hours

## Related APIs

* **[Kling 3](/api-reference/video/kling-v3/overview)**: Standard Kling 3.0 model for higher-fidelity output
* **[Kling 2.6](/api-reference/image-to-video/kling-v2-6/task-by-id)**: Previous-generation Kling with motion control
* **[WAN 2.7](/api-reference/text-to-video/wan-2-7/overview)**: Alternative t2v and i2v model with multi-shot sequences
* **[Runway Gen-4 Turbo](/api-reference/image-to-video/runway-gen4-turbo)**: Fast i2v alternative with cinematic quality