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

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

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

{/* source_updated_at: 1782169057 */}

**Model ID**

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

**Calling method:** async

# Kling-Image2Video-V2-Master API Usage Guide

## Overview

**Kling-Image2Video-V2-Master** is Kling AI’s advanced image-to-video generation model, capable of transforming static images into dynamic, imaginative videos.\
With greatly improved dynamics, aesthetics, and prompt adherence, this model brings your images to life with smooth motion and creative storytelling.

## Key Features

* **Image-to-Video Generation**: Transform static images into dynamic videos
* **Enhanced Dynamics**: Greatly improved motion and movement quality
* **Superior Aesthetics**: Advanced visual quality and artistic rendering
* **Strong Prompt Adherence**: Better interpretation of text prompts
* **Flexible Duration**: Generate videos from 5 to 10 seconds
* **Multiple Input Formats**: Support for Base64 encoding and image URLs
* **Creative Control**: CFG scale parameter for fine-tuning generation

## 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-Master",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "image": "https://example.com/reference-image.jpg",
      "duration": "5",
      "negative_prompt": "blurry, low quality, distorted",
      "cfg_scale": 0.7
    }
 }'
```

## Request Parameters

| Parameter         | Type   | Required | Description                              | Default | Constraints                                                 |
| ----------------- | ------ | -------- | ---------------------------------------- | ------- | ----------------------------------------------------------- |
| `prompt`          | string | No       | Text prompt describing the desired video | ""      | Max 2500 characters                                         |
| `image`           | string | Yes      | Reference image (URL)                    | -       | Max 10MB, min 300px dimensions, aspect ratio 1:2.5 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       | Generation flexibility control           | 0.5     | 0.0 to 1.0                                                  |

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Image2Video-V2-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-Master",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
    "image": "https://example.com/reference-image.jpg",
    "duration": "5",
    "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/apikey/requests?model_id=Kling-Image2Video-V2-Master
```

### Example

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

## Get Model Information

### Endpoint

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

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/Kling-Image2Video-V2-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-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

## Video Specifications

* **Duration**: 5–10 seconds
* **Input Image Requirements**:
  * Formats: JPG, JPEG, PNG
  * Max file size: 10MB
  * Min dimensions: 300px width/height
  * Aspect ratio: 1:2.5 to 2.5:1
* **Quality**: High-definition with improved dynamics and aesthetics

## Tips for Better Results

1. **High-Quality Reference Images**: Use clear, high-resolution images for better video quality
2. **Appropriate Image Dimensions**: Ensure images meet minimum size requirements (300px+)
3. **Clear, Descriptive Prompts**: Use specific descriptions to guide the video generation
4. **Motion Description**: Include details about desired movement and dynamics
5. **CFG Scale Tuning**:
   * Lower values (0.3–0.5): More creative, less prompt adherence
   * Higher values (0.7–1.0): More prompt adherence, less creative variation
6. **Negative Prompts**: Specify unwanted elements to improve quality
7. **Duration Planning**: Use 5 seconds for quick concepts, 10 seconds for more complex scenes