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-Text2Video-V2.1-Master

​
Kling-Text2Video-V2.1-Master API Usage Guide

​
Overview

Kling-Text2Video-V2.1-Master is a state-of-the-art text-to-video generation model that creates imaginative videos from text descriptions. This model represents a significant improvement in dynamics, aesthetics, and prompt adherence, making it ideal for creating high-quality video content from simple text prompts.

​
Key Features

  • Enhanced Dynamics: Greatly improved motion and fluidity in generated videos
  • Superior Aesthetics: Better visual quality and artistic style
  • Strong Prompt Adherence: More accurate interpretation of text descriptions
  • Multiple Aspect Ratios: Support for 16:9, 9:16, and 1:1 aspect ratios
  • Flexible Duration: 5 or 10-second video generation options

​
Use Cases

  • Creative video content generation
  • Marketing and advertising videos
  • Educational content creation
  • Entertainment and storytelling
  • Prototype and concept visualization

​
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-Text2Video-V2.1-Master",
    "payload": {
      "prompt": "A majestic dragon soaring through a mystical forest with glowing eyes and flowing scales",
      "negative_prompt": "blurry, low quality, distorted",
      "duration": "5",
      "aspect_ratio": "16:9",
      "cfg_scale": 0.5
    }
}'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringNoText prompt describing the desired video""Max 2500 characters
negative_promptstringNoText describing what to avoid""Max 2500 characters
durationstringNoVideo length in seconds"5"Options: "5", "10"
aspect_ratiostringNoVideo aspect ratio"16:9"Options: "16:9", "9:16", "1:1"
cfg_scalefloatNoFlexibility in video generation0.50.0 to 1.0, step 0.1

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Text2Video-V2.1-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-Text2Video-V2.1-Master",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic dragon soaring through a mystical forest with glowing eyes and flowing scales",
    "negative_prompt": "blurry, low quality, distorted",
    "duration": "5",
    "aspect_ratio": "16:9",
    "cfg_scale": 0.5
  },
  "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-Text2Video-V2.1-Master

​
Example

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

​
Get Model Information

​
Endpoint

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

​
Example

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

​
Tips for Better Results

  1. Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality
  2. Negative Prompts: Use negative prompts to avoid unwanted elements like “blurry, low quality, distorted”
  3. Aspect Ratio Selection: Choose the right aspect ratio for your target platform
    • 16:9: Landscape videos, cinematic content
    • 9:16: Mobile viewing, social media stories
    • 1:1: Social media posts, Instagram
  4. CFG Scale Tuning: Adjust the flexibility of video generation
    • 0.0–0.3: High flexibility, creative variations
    • 0.4–0.6: Balanced creativity and prompt adherence (recommended)
    • 0.7–1.0: Strong prompt adherence, less creative variation
  5. Duration Considerations: Choose appropriate video length
    • 5 seconds: Quick content, social media, previews
    • 10 seconds: More detailed scenes, longer narratives

​
Video Specifications

  • Duration: 5 or 10 seconds
  • Aspect Ratios: 16:9, 9:16, 1:1
  • Quality: High definition with excellent detail and clarity