> ## 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-5-turbo

> API usage guide for kling-v2-5-turbo.

{/* source_model_id: kling-v2-5-turbo */}

{/* source_updated_at: 1782169269 */}

**Model ID**

```bash theme={null}
kling-v2-5-turbo
```

**Calling method:** async

# kling-v2-5-turbo API Usage Guide

## Overview

**kling-v2-5-turbo** 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-5-turbo",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "image": "https://example.com/image.jpg",
      "duration": "5",
      "negative_prompt": "blurry, low quality, distorted",
      "mode": "pro",
      "cfg_scale": 0.5
    }
  }'
```

### Request Parameters

| Parameter         | Type   | Required | Description                                                                                                                                                                                                                    | Default | Constraints          |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | -------------------- |
| `prompt`          | string | Yes      | Positive 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.         |
| `duration`        | string | No       | Video Length, unit: s (seconds).                                                                                                                                                                                               | "5"     | Options: "5", "10"   |
| `negative_prompt` | string | No       | Negative text prompt. Cannot exceed 2500 characters.                                                                                                                                                                           | ""      | Optional             |
| `mode`            | string | No       | -                                                                                                                                                                                                                              | "pro"   | Options: "pro"       |
| `cfg_scale`       | float  | 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     | 0 to 1 with step 0.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-5-turbo",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
    "image": "https://example.com/image.jpg",
    "duration": "5",
    "negative_prompt": "blurry, low quality, distorted",
    "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                   |

## List Your Requests

### Endpoint

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

### Example

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

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/kling-v2-5-turbo
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models/kling-v2-5-turbo" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## List Available Models

### Endpoint

```
GET /api/v1/apikey/models
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
    "model_ids": [
        "kling-v2-5-turbo",
        "other-model-1",
        "other-model-2"
    ]
}
```

## Pricing

* **Pricing Type**: Video length based pricing
* **Unit Price**: \$0.07 per second

## Tips for Better Results

1. **Clear, Descriptive Prompts**: Use specific, detailed descriptions for better video quality
2. **Negative Prompts**: Specify unwanted elements to improve quality