Model ID

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:

Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Endpoint

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

Request Format

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

{
  "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

curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "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

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

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

curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "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

Clear Prompts
Use descriptive, specific prompts for better video quality.
High-Quality Images
Use sharp, well-lit reference images.
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
Negative Prompts
Specify unwanted elements (e.g., “blurry, distorted faces”).

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Kling-Image2Video-V2.1-Master

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

Overview

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Image Requirements

Tips for Better Results

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

​Overview

​Authentication

​Submit Video Generation Request

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Pricing

​Image Requirements

​Tips for Better Results

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

Overview

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Image Requirements

Tips for Better Results