Model ID

Kling-Image2Video-V2.1-Standard

Calling method: async

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

Overview

The Kling-Image2Video-V2.1-Standard 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-Standard",
    "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
    }
 }'

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 (Base64 or URL)	-	JPG/JPEG/PNG, 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	Higher = less flexibility, stronger prompt adherence

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Image2Video-V2.1-Standard",
  "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-Standard",
  "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-Standard

Example

curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Kling-Image2Video-V2.1-Standard' \
--header 'Authorization: Bearer YOUR_API_KEY'

Get Model Information

Endpoint

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

Example

curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/Kling-Image2Video-V2.1-Standard' \
--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-Standard",
    "other-model-1",
    "other-model-2"
  ]
}

Pricing

Pricing Type: Video length based pricing
Price: $0.056 per second
Unit: Second

Example cost calculation:

5-second video: 5 × $0.056 =$ 0.28
10-second video: 10 × $0.056 =$ 0.56

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 what you don’t want to avoid common issues

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Kling-Image2Video-V2.1-Standard

Kling-Image2Video-V2.1-Standard 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-Standard 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-Standard 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