> ## 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-v2-6

> API usage guide for kling-v2-6.

{/* source_model_id: kling-v2-6 */}

{/* source_updated_at: 1782169139 */}

**Model ID**

```bash theme={null}
kling-v2-6
```

**Calling method:** async

# kling-v2-6 API Usage Guide

## Overview

**kling-v2-6** is Kling AI's latest-generation video-synthesis model, capable of transforming text descriptions or reference images into polished, high-fidelity video clips with cinematic camera work, smooth realistic motion, and consistent visual style. It features stronger prompt understanding that can handle complex, multi-step instructions and causal relationships, improved physics-aware dynamics and stable camera control for fluid, natural action scenes, and greatly enhanced style/lighting/texture consistency across frames.

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Video Generation Request

### Base URL

```
https://console.gmicloud.ai
```

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```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-v2-6"",
    ""payload"": {
      ""prompt"": ""A majestic eagle soaring through a mountain landscape at sunset"",
      ""sound"": ""on"",
      ""image"": ""https://example.com/image.jpg"",
      ""duration"": ""5"",
      ""mode"": ""pro"",
      ""cfg_scale"": 0.5
    }
  }'
```

### Request Parameters

| Parameter   | Type   | Required | Description                                                                                                                                                                                                                    | Default | Constraints      |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | ---------------- |
| `prompt`    | string | Yes      | Text prompt. Cannot exceed 2500 characters.                                                                                                                                                                                    | -       | Required         |
| `image`     | string | No       | Support image URL (.jpg/.jpeg/.png). The image file size cannot exceed 10MB, andthe width and height dimensions of the image shall not be less than 300px, and the aspect ratio of the image should be between 1:2.5 \~ 2.5:1. | -       | Max 1 image.     |
| `sound`     | string | No       | Whether to have sound or not                                                                                                                                                                                                   | no      | Options: yes, no |
| `duration`  | string | No       | Video Length, unit: s (seconds).                                                                                                                                                                                               | 5       | Options: 5, 10   |
| `mode`      | string | No       | -                                                                                                                                                                                                                              | pro     | Options: pro     |
| `cfg_scale` | string | No       | Flexibility in video generation; The higher the value, the lower the model's degree of flexibility, and the stronger the relevance to the user's prompt.                                                                       | 0.5     | Min: 0, Max: 1   |

### Response

```json theme={null}
{
  ""request_id"": ""550e8400-e29b-41d4-a716-446655440000"",
  ""model"": ""kling-v2-5-turbo"",
  ""status"": ""queued"",
  ""created_at"": 1750442925,
  ""updated_at"": 1750442925,
  ""queued_at"": 1750442925
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Example

```bash theme={null}
curl -X GET ""https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000"" \
  -H ""Authorization: Bearer YOUR_API_KEY""
```

### Response

```json theme={null}
{
  ""request_id"": ""550e8400-e29b-41d4-a716-446655440000"",
  ""org_id"": ""your-org-id"",
  ""model"": ""kling-v2-6"",
  ""status"": ""success"",
  ""is_public"": false,
  ""payload"": {
    ""prompt"": ""A majestic eagle soaring through a mountain landscape at sunset"",
    ""sound"": ""on"",
    ""image"": ""https://example.com/image.jpg"",
    ""duration"": ""5"",
    ""mode"": ""pro"",
    ""cfg_scale"": 0.5,

  },
  ""outcome"": {
    ""video_url"": ""https://storage.googleapis.com/bucket/generated-video.mp4"",
    ""thumbnail_image_url"": ""https://storage.googleapis.com/bucket/thumbnail.jpg""
  },
  ""created_at"": 1750442925,
  ""updated_at"": 1750442930,
  ""queued_at"": 1750442925
}
```

## Request Status Values

| Status       | Description                             |
| ------------ | --------------------------------------- |
| `queued`     | Request is waiting to be processed      |
| `processing` | Video generation is in progress         |
| `success`    | Video generation completed successfully |
| `failed`     | Video generation failed                 |
| `cancelled`  | Request was cancelled                   |

### Endpoint

```
GET api/v1/ie/requestqueue/apikey/requests?model_id=kling-v2-6
```

### Example

```bash theme={null}
curl -X GET ""https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=kling-v2-6"" \
  -H ""Authorization: Bearer YOUR_API_KEY""
```

## Pricing

* **Pricing Type**: Video length based pricing
* **Unit Price**: $0.07 per second (no audio), $0.14 per second (with audio)