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-V1.6-Pro

​
Kling-Image2Video-V1.6-Pro API Usage Guide

​
Overview

Kling-Image2Video-V1.6-Pro is Kling AI’s professional-grade image-to-video model that transforms static images into smooth, dynamic video clips with improved realism and consistency. With 195% overall improvement compared to previous versions, this model delivers enhanced prompt adherence and more consistent, dynamic visuals for professional creators.

​
Key Features:

  • Professional Mode: Advanced features for creators needing more control and detail
  • 195% Performance Improvement: Significant upgrade over previous versions
  • Enhanced Prompt Adherence: More accurate and meaningful results
  • Consistent Dynamic Visuals: Improved realism and creativity in generated videos
  • 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/apikey/requests

​
Request Format

curl -X POST "https://api.example.com/api/v1/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Kling-Image2Video-V1.6-Pro",
    "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
modelstringYesModel identifier-Must be “Kling-Image2Video-V1.6-Pro”
payload.promptstringNoText prompt describing the desired video""Max 2500 characters
payload.imagestringYesReference image (Base64 or URL)-Max 10MB, min 300px dimensions, aspect ratio 1:2.5 to 2.5:1
payload.durationstringNoVideo length in seconds”5”Options: “5”, “10”
payload.negative_promptstringNoText describing what to avoid""Max 2500 characters
payload.cfg_scalefloatNoGeneration flexibility control0.50.0 to 1.0

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Image2Video-V1.6-Pro",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}

​
Check Request Status

​
Endpoint

GET /api/v1/apikey/requests/{request_id}

​
Example

curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "your-org-id",
  "model": "Kling-Image2Video-V1.6-Pro",
  "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"
  },
  "qworker_id": "worker-123",
  "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/apikey/requests?model_id=Kling-Image2Video-V1.6-Pro

​
Example

curl -X GET "https://api.example.com/api/v1/apikey/requests?model_id=Kling-Image2Video-V1.6-Pro" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get Model Information

​
Endpoint

GET /api/v1/apikey/models/Kling-Image2Video-V1.6-Pro

​
Example

curl -X GET "https://api.example.com/api/v1/apikey/models/Kling-Image2Video-V1.6-Pro" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
List Available Models

​
Endpoint

GET /api/v1/apikey/models

​
Example

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "model_ids": [
    "Kling-Image2Video-V1.6-Pro",
    "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: Professional-grade with improved realism and consistency
  • Format: MP4 video with thumbnail image

​
Tips for Better Results

  1. High-Quality Reference Images: Use clear, high-resolution images for optimal results
  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
  7. Duration Planning: Use 5 seconds for quick concepts, 10 seconds for more complex scenes
  8. Professional Workflow: Leverage the Pro mode for advanced control and detail

​
Parameter Examples

​
Professional Nature Scene

{
  "prompt": "A majestic eagle soaring gracefully through mountain peaks with dynamic camera movement",
  "image": "https://example.com/eagle-image.jpg",
  "duration": "10",
  "negative_prompt": "blurry, low quality, distorted, static",
  "cfg_scale": 0.8
}

​
Dynamic Urban Animation

{
  "prompt": "A bustling city street with flowing traffic, moving crowds, and dynamic lighting",
  "image": "https://example.com/city-image.jpg",
  "duration": "8",
  "negative_prompt": "empty, quiet, static, dark",
  "cfg_scale": 0.7
}

​
Artistic Professional Animation

{
  "prompt": "A flowing river with gentle ripples, moving reflections, and cinematic camera angles",
  "image": "https://example.com/river-image.jpg",
  "duration": "5",
  "negative_prompt": "rough, turbulent, dark, low quality",
  "cfg_scale": 0.9
}