> ## 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-v3-image-to-video

> API usage guide for kling-v3-image-to-video.

{/* source_model_id: kling-v3-image-to-video */}

{/* source_updated_at: 1782169355 */}

**Model ID**

```bash theme={null}
kling-v3-image-to-video
```

**Calling method:** async

# Kling I2V (v3.0) API Documentation

Kling v3.0 is a professional-grade image-to-video foundation model. It specializes in cinematic 720p generation with native audio-visual synchronization and precise "start-to-end" frame guidance.

## 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.084 (std, per second, no audio); $0.126 (std, per second, with audio); $0.168 (pro, per second, with audio); $0.42 (4k, per second)
* Duration: 3-15 seconds
* Resolution: Cinematic 720p/1080p/4k
* Features: Native Audio, Start/End Frame Guidance

## 3. Motion & Guidance Logic

### Start & End Frame Guidance

You can provide both a starting image (image) and an ending image (image\_tail) to dictate the exact transition of the video. The model intelligently interpolates the motion between these two specific visual states.

### Native Audio Generation

When 'sound' is enabled, the model generates synchronized ambient sound or dialogue based on the prompt. This increases the per-second rate to \$0.252.

## 4. Parameter Reference

| Parameter        | Type   | Required | Description                                               |
| :--------------- | :----- | :------- | :-------------------------------------------------------- |
| prompt           | string | Yes      | Describe the motion and action (up to 2500 chars).        |
| image            | string | Yes      | The starting frame image (Base64 string or URL).          |
| image\_tail      | string | No       | Optional end frame image to guide the video's conclusion. |
| negative\_prompt | string | No       | Elements to exclude (e.g., 'blurry, distorted').          |
| duration         | enum   | No       | Total duration in seconds (3-15). Default: "5".           |
| sound            | enum   | No       | Generate synchronized audio. Options: "on", "off".        |
| mode             | enum   | No       | Resolution of output video. Options: "std", "pro", "4k".  |

## 5. Example CURL Request

```bash theme={null}
curl -X POST "[https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests](https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests)" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-image-to-video",
    "payload": {
      "image": "[https://example.com/start_frame.jpg](https://example.com/start_frame.jpg)",
      "image_tail": "[https://example.com/end_frame.jpg](https://example.com/end_frame.jpg)",
      "prompt": "A cinematic shot of a dragon taking flight from a cliffside.",
      "duration": "5",
      "sound": "on"
    }
  }'
```

## 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.