Skip to main content
Model ID 
Kling-Image2Video-V2.1-Standard

​
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

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringNoText prompt describing the desired video""Max 2500 characters
imagestringYesReference image (Base64 or URL)-JPG/JPEG/PNG, max 10MB, min 300px dimensions, aspect ratio 1:2.5 to 2.5:1
durationstringNoVideo length in seconds”5”Options: “5”, “10”
negative_promptstringNoText describing what to avoid""Max 2500 characters
cfg_scalefloatNoGeneration flexibility control0.5Higher = 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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest 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"
  ]
}

​
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