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

# kling-3.0-turbo-i2v

> API usage guide for kling-3.0-turbo-i2v.

{/* source_model_id: kling-3.0-turbo-i2v */}

{/* source_updated_at: 1782764783 */}

**Model ID**

```bash theme={null}
kling-3.0-turbo-i2v
```

**Calling method:** async

# Kling I2V (v3.0 Turbo) API Documentation

Kling v3.0 Turbo is a high-speed image-to-video foundation model. It animates a single source image into cinematic video, with an optional text prompt to direct the motion and selectable resolution (720p/1080p), optimized for fast "turbo" generation.

## 1. API Endpoint & Authentication

Base URL: [https://console.gmicloud.ai](https://console.gmicloud.ai)
Endpoint: POST /api/v1/ie/requestqueue/apikey/requests
Header:
Authorization: Bearer YOUR\_API\_KEY
Content-Type: application/json

## 2. Model Specifications

* Pricing: $0.112 per second ($0.14 per second at 1080p)
* Duration: 3-15 seconds
* Resolution: 720p (default) or 1080p
* Features: Turbo (accelerated) generation, single-image animation, optional prompt-guided motion

## 3. Generation Logic

### Image-to-Video Synthesis

Provide a starting frame image and the model animates it into video. A text prompt is optional. Supplying one lets you steer the motion and action; omitting it lets the model infer plausible motion from the image alone.

### Resolution

Output defaults to 720p at the base rate. Selecting 1080p increases the per-second rate to \$0.14. The output framing follows the dimensions of the source image.

## 4. Parameter Reference

| Parameter    | Type   | Required | Description                                                           |
| :----------- | :----- | :------- | :-------------------------------------------------------------------- |
| first\_frame | image  | Yes      | The starting frame image for video generation (Base64 string or URL). |
| prompt       | string | No       | Describe the motion and action (up to 2500 chars).                    |
| resolution   | enum   | No       | Output resolution: '720p' or '1080p'. Default: "720p".                |
| duration     | enum   | No       | Total duration in seconds (3-15). Default: "5".                       |

## 5. Example CURL Request

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo-i2v",
    "payload": {
      "first_frame": "https://example.com/start_frame.jpg",
      "prompt": "A cinematic shot of a dragon taking flight from a cliffside.",
      "resolution": "720p",
      "duration": "5"
    }
  }'
```

## 6. Checking Request Status

```bash theme={null}
Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

* queued: Request is waiting to be processed by GPU resources.
* processing: Video generation is currently in progress.
* success: Generation completed. URLs available in outcome.media\_urls.
* failed: Video generation failed. Check logs for details.