Model ID

Kling-Text2Video-V2.1-Master

Calling method: async

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

Parameter	Type	Required	Description	Default	Constraints
`prompt`	string	No	Text prompt describing the desired video	`""`	Max 2500 characters
`negative_prompt`	string	No	Text describing what to avoid	`""`	Max 2500 characters
`duration`	string	No	Video length in seconds	`"5"`	Options: `"5"`, `"10"`
`aspect_ratio`	string	No	Video aspect ratio	`"16:9"`	Options: `"16:9"`, `"9:16"`, `"1:1"`
`cfg_scale`	float	No	Flexibility in video generation	`0.5`	`0.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

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/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

Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality
Negative Prompts: Use negative prompts to avoid unwanted elements like “blurry, low quality, distorted”
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
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
Duration Considerations: Choose appropriate video length
- 5 seconds: Quick content, social media, previews
- 10 seconds: More detailed scenes, longer narratives

Pricing

Pricing Type: Video length based pricing
Price: $0.28 per second
Unit: Second

Example cost calculation:

5-second video: 5 × $0.28 =$ 1.40
10-second video: 10 × $0.28 =$ 2.80

Video Specifications

Duration: 5 or 10 seconds
Aspect Ratios: 16:9, 9:16, 1:1
Quality: High definition with excellent detail and clarity
Format: MP4 video with thumbnail image

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Kling-Text2Video-V2.1-Master

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

Overview

Key Features

Use Cases

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Tips for Better Results

Pricing

Video Specifications

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

​Overview

​Key Features

​Use Cases

​Authentication

​Submit Video Generation Request

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Tips for Better Results

​Pricing

​Video Specifications

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

Overview

Key Features

Use Cases

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Tips for Better Results

Pricing

Video Specifications