Model ID

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:

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

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

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

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

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

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

Response

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

High-Quality Reference Images: Use clear, high-resolution images for better video quality
Appropriate Image Dimensions: Ensure images meet minimum size requirements (300px+)
Clear, Descriptive Prompts: Use specific descriptions to guide the video generation
Motion Description: Include details about desired movement and dynamics
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
Negative Prompts: Specify unwanted elements to improve quality
Duration Planning: Use 5 seconds for quick concepts, 10 seconds for more complex scenes

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Kling-Image2Video-V2-Master

Kling-Image2Video-V2-Master API Usage Guide

Overview

Key Features

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

Video Specifications

Tips for Better Results

​Kling-Image2Video-V2-Master API Usage Guide

​Overview

​Key Features

​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

​Video Specifications

​Tips for Better Results

Kling-Image2Video-V2-Master API Usage Guide

Overview

Key Features

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

Video Specifications

Tips for Better Results