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

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

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

{/* source_updated_at: 1750442925 */}

**Model ID**

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

**Calling method:** async

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

## Overview

The **Kling-Image2Video-V2.1-Master** model generates videos from reference images using state-of-the-art generative AI methods. This model is perfect for creating dynamic video content from static images with enhanced dynamics, aesthetics, and prompt adherence.

## 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-Image2Video-V2.1-Master",
    "payload": {
      "prompt": "Three dogs are racing bicycles on a street",
      "image": "https://storage.googleapis.com/gmi-video-assests/thumbnail_images/dogs.jpg",
      "duration": "5",
      "negative_prompt": "blurry, low quality, distorted",
      "cfg_scale": 0.7
    }
}'
```

### Request Parameters

| Parameter         | Type   | Required | Description                                                  | Default | Constraints                                                              |
| ----------------- | ------ | -------- | ------------------------------------------------------------ | ------- | ------------------------------------------------------------------------ |
| `prompt`          | string | No       | Positive text prompt describing the desired video            | ""      | Max 2500 characters                                                      |
| `image`           | string | Yes      | Reference image (this needs to be a publicly accessible URL) | -       | JPG/JPEG/PNG, max 10MB, min 300px dimensions, aspect ratio 1.25 to 2.5:1 |
| `duration`        | string | No       | Video length in seconds                                      | "5"     | Options: "5", "10"                                                       |
| `negative_prompt` | string | No       | Text describing what to avoid                                | ""      | Max 2500 characters                                                      |
| `cfg_scale`       | float  | No       | Flexibility control (0.0-1.0)                                | 0.5     | Higher = less flexibility, stronger prompt adherence                     |

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Image2Video-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-Image2Video-V2.1-Master",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A beautiful sunset over the ocean with gentle waves",
    "image": "https://example.com/sunset-image.jpg",
    "duration": "10",
    "negative_prompt": "blurry, low quality, distorted",
    "cfg_scale": 0.7
  },
  "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/requests?model_id=Kling-Image2Video-V2.1-Master
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Kling-Image2Video-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-Image2Video-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-Image2Video-V2.1-Master",
    "other-model-1",
    "other-model-2"
  ]
}
```

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

***

## Image Requirements

**Formats**: JPG, JPEG, PNG\
**Max Size**: 10MB\
**Min Dimensions**: 300px width and height\
**Aspect Ratio**: Between 1:2.5 and 2.5:1

***

## Tips for Better Results

1. **Clear Prompts**\
   Use descriptive, specific prompts for better video quality.

2. **High-Quality Images**\
   Use sharp, well-lit reference images.

3. **Appropriate CFG Scale**
   * *Lower values (0.3\~0.5)*: More creative, less prompt adherence
   * *Higher values (0.7\~1.0)*: More faithful to prompt, less creative

4. **Negative Prompts**\
   Specify unwanted elements (e.g., "blurry, distorted faces").