Skip to main content

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.

Model ID 
Kling-Image2Video-V2-Master

​
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

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringNoText prompt describing the desired video""Max 2500 characters
imagestringYesReference image (URL)-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.50.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

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/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"
  ]
}

​
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