> ## 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 Image To Video API

> Animate a single image into video fast with Kling 3.0 Turbo. Dedicated 720p and 1080p generate endpoints, 3-15 second durations, and optional prompt-guided motion control.

<Card title="Kling 3.0 Turbo integration" icon="video">
  Kling 3.0 Turbo is the fast generation model from the Kling 3.0 family, animating a first-frame image into smooth, high-fidelity video with short processing times.
</Card>

Kling 3.0 Turbo image-to-video generates a video from a single first-frame image, optionally guided by a text prompt. It outputs high-fidelity video with durations from 3 to 15 seconds, and is optimized for fast generation, making it well suited for animating product shots, artwork, and social media content at scale.

Resolution is selected at generation time: use the dedicated **720p** generate endpoint for standard high definition or the **1080p** generate endpoint for full high definition. Task status and listing use a single generic endpoint, regardless of the resolution. For the full model overview, including the text-to-video mode, see the [Kling 3.0 Turbo overview](/api-reference/text-to-video/kling-v3-turbo/overview).

### Key capabilities

* **Image animation**: Turn a single first-frame image into motion
* **Resolution by generate endpoint**: Dedicated `720p` and `1080p` generate endpoints
* **Unified task tracking**: One generic list endpoint and one generic status endpoint for tasks of any resolution
* **Fast generation**: Turbo-optimized pipeline for shorter processing times
* **Flexible durations**: Any whole number from 3 to 15 seconds, default `5`
* **Optional prompt**: Guide motion and style with up to 2500 characters, or omit it to infer motion from the image
* **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

* **Product videos**: Animate static product photography for ads and listings
* **Social media content**: Bring images to life for Reels, Shorts, and Stories
* **Creative exploration**: Add motion to illustrations, concept art, and designs
* **Rapid prototyping**: Quickly preview how a still composition moves

## API Operations

<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          | Endpoint                                             |
| ------------------ | ---------------------------------------------------- |
| **Generate 720p**  | `POST /v1/ai/image-to-video/kling-v3-turbo-720p`     |
| **Generate 1080p** | `POST /v1/ai/image-to-video/kling-v3-turbo-1080p`    |
| **List tasks**     | `GET /v1/ai/image-to-video/kling-v3-turbo`           |
| **Get task**       | `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.

| 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="How do I choose 720p or 1080p?">
    Resolution is selected by the generate endpoint, not by a body parameter. Call `POST /v1/ai/image-to-video/kling-v3-turbo-720p` for standard high definition or `POST /v1/ai/image-to-video/kling-v3-turbo-1080p` for full high definition. Listing and status use the single generic endpoint `GET /v1/ai/image-to-video/kling-v3-turbo` (and `/{task-id}`).
  </Accordion>

  <Accordion title="What image formats and sizes are supported?">
    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="Is the prompt required for image-to-video?">
    No. The prompt is optional in image-to-video. If you omit it, motion is inferred from the source image. Provide a prompt (up to 2500 characters) to guide the movement, camera behavior, and visual style.
  </Accordion>

  <Accordion title="Can I set the aspect ratio for image-to-video?">
    No. Image-to-video does not accept an aspect ratio parameter; the output ratio is inherited from the source image. Use text-to-video if you need to choose `16:9`, `9:16`, or `1:1`.
  </Accordion>

  <Accordion title="What durations are supported?">
    Any whole-number duration from 3 to 15 seconds (default `5`). Shorter durations generate faster.
  </Accordion>

  <Accordion title="How do I get the generated video?">
    Submit the request to receive a task ID, then poll the generic 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 and pricing?">
    Rate limits depend on your subscription tier (see [Rate Limits](/ratelimits)). Pricing varies by resolution and duration (see [Pricing](/pricing)).
  </Accordion>
</AccordionGroup>

## Related APIs

* **[Kling 3.0 Turbo (Text to Video)](/api-reference/text-to-video/kling-v3-turbo/overview)**: Generate video from a text prompt with aspect ratio control
* **[Kling 3](/api-reference/video/kling-v3/overview)**: Standard Kling 3.0 model for higher-fidelity output
* **[Runway Gen-4 Turbo](/api-reference/image-to-video/runway-gen4-turbo)**: Fast i2v alternative with cinematic quality