> ## 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-Text2Video-V2.1-Master

> API usage guide for Kling-Text2Video-V2.1-Master.

{/* source_model_id: Kling-Text2Video-V2.1-Master */}

{/* source_updated_at: 1750445578 */}

**Model ID**

```bash theme={null}
Kling-Text2Video-V2.1-Master
```

**Calling method:** async

# Kling-Text2Video-V2.1-Master API Usage Guide

## Overview

Kling-Text2Video-V2.1-Master is a state-of-the-art text-to-video generation model that creates imaginative videos from text descriptions. This model represents a significant improvement in dynamics, aesthetics, and prompt adherence, making it ideal for creating high-quality video content from simple text prompts.

## Key Features

* **Enhanced Dynamics**: Greatly improved motion and fluidity in generated videos
* **Superior Aesthetics**: Better visual quality and artistic style
* **Strong Prompt Adherence**: More accurate interpretation of text descriptions
* **Multiple Aspect Ratios**: Support for 16:9, 9:16, and 1:1 aspect ratios
* **Flexible Duration**: 5 or 10-second video generation options

## Use Cases

* Creative video content generation
* Marketing and advertising videos
* Educational content creation
* Entertainment and storytelling
* Prototype and concept visualization

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

### Endpoint

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

### Request Format

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "Kling-Text2Video-V2.1-Master",
    "payload": {
      "prompt": "A majestic dragon soaring through a mystical forest with glowing eyes and flowing scales",
      "negative_prompt": "blurry, low quality, distorted",
      "duration": "5",
      "aspect_ratio": "16:9",
      "cfg_scale": 0.5
    }
}'
```

### Request Parameters

| Parameter         | Type   | Required | Description                              | Default  | Constraints                          |
| ----------------- | ------ | -------- | ---------------------------------------- | -------- | ------------------------------------ |
| `prompt`          | string | No       | Text prompt describing the desired video | `""`     | Max 2500 characters                  |
| `negative_prompt` | string | No       | Text describing what to avoid            | `""`     | Max 2500 characters                  |
| `duration`        | string | No       | Video length in seconds                  | `"5"`    | Options: `"5"`, `"10"`               |
| `aspect_ratio`    | string | No       | Video aspect ratio                       | `"16:9"` | Options: `"16:9"`, `"9:16"`, `"1:1"` |
| `cfg_scale`       | float  | No       | Flexibility in video generation          | `0.5`    | `0.0` to `1.0`, step `0.1`           |

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Text2Video-V2.1-Master",
  "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 --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "your-org-id",
  "model": "Kling-Text2Video-V2.1-Master",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic dragon soaring through a mystical forest with glowing eyes and flowing scales",
    "negative_prompt": "blurry, low quality, distorted",
    "duration": "5",
    "aspect_ratio": "16:9",
    "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-Text2Video-V2.1-Master
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Kling-Text2Video-V2.1-Master' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/Kling-Image2Video-V2.1-Master
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/Kling-Text2Video-V2.1-Master' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

## List Available Models

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

### Response

```json theme={null}
{
  "model_ids": [
    "Kling-Text2Video-V2.1-Master",
    "other-model-1",
    "other-model-2"
  ]
}
```

# Tips for Better Results

1. **Clear, Descriptive Prompts**: Use specific, detailed descriptions for better video quality

2. **Negative Prompts**: Use negative prompts to avoid unwanted elements like "blurry, low quality, distorted"

3. **Aspect Ratio Selection**: Choose the right aspect ratio for your target platform
   * **16:9**: Landscape videos, cinematic content
   * **9:16**: Mobile viewing, social media stories
   * **1:1**: Social media posts, Instagram

4. **CFG Scale Tuning**: Adjust the flexibility of video generation
   * **0.0–0.3**: High flexibility, creative variations
   * **0.4–0.6**: Balanced creativity and prompt adherence (recommended)
   * **0.7–1.0**: Strong prompt adherence, less creative variation

5. **Duration Considerations**: Choose appropriate video length
   * **5 seconds**: Quick content, social media, previews
   * **10 seconds**: More detailed scenes, longer narratives

## Pricing

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

Example cost calculation:

* 5-second video: 5 × $0.28 = $1.40
* 10-second video: 10 × $0.28 = $2.80

## Video Specifications

* **Duration**: 5 or 10 seconds
* **Aspect Ratios**: 16:9, 9:16, 1:1
* **Quality**: High definition with excellent detail and clarity
* **Format**: MP4 video with thumbnail image