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.1-Pro
Kling-Image2Video-V2.1-Pro API Usage Guide
Overview
The Kling-Image2Video-V2.1-Pro 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
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-Pro",
"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 (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-Pro",
"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-Pro",
"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-Pro
Example
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Kling-Image2Video-V2.1-Pro' \
--header 'Authorization: Bearer YOUR_API_KEY'
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/Kling-Image2Video-V2.1-Pro
Example
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/Kling-Image2Video-V2.1-Pro' \
--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-Pro",
"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
- 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
