Model ID

Kling-Text2Video-V2-Master

Calling method: async

Kling-Text2Video-V2-Master API Usage Guide

Overview

Kling-Text2Video-V2-Master is a powerful text-to-video generation model that creates imaginative videos from text descriptions.
This model offers excellent dynamics, aesthetics, and prompt adherence, making it ideal for creating high-quality video content from simple text prompts.

Key Features

Enhanced Dynamics: Improved motion and fluidity in generated videos
Superior Aesthetics: High visual quality and artistic style
Strong Prompt Adherence: 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-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
`model`	string	Yes	Model identifier	-	Must be “Kling-Text2Video-V2-Master”
`payload.prompt`	string	No	Text prompt describing the desired video	""	Max 2500 characters
`payload.image`	string	Yes	Reference image (Base64 or URL)	-	Max 2500 characters
`payload.duration`	string	No	Video length in seconds	”5”	Options: “5”, “10”
`payload.negative_prompt`	string	No	Text describing what to avoid	""	“16:9”, “9:16”, “1:1”
`payload.cfg.scale`	float	No	Generation flexibility control	0.5	0.0 to 1.0, step 0.1

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Kling-Text2Video-V2-Master",
  "status": "queued",
  "created_at": 1749618001,
  "updated_at": 1749618001,
  "queued_at": 1749618001
}

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-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"
  },
  "qworker_id": "worker-123",
  "created_at": 1749618001,
  "updated_at": 1749618008,
  "queued_at": 1749618001
}

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

Example

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

Get Model Information

Endpoint

GET /api/v1/apikey/models/Kling-Text2Video-V2-Master

Example

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

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–10 seconds
Aspect Ratios:
- Landscape: 16:9 (default)
- Portrait: 9:16
- Square: 1:1
Quality: High-definition with excellent detail and clarity

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
CFG Scale Tuning: Adjust the flexibility of video generation
Duration Considerations: Choose appropriate video length

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Kling-Text2Video-V2-Master

Kling-Text2Video-V2-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

Pricing

Video Specifications

Tips for Better Results

​Kling-Text2Video-V2-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

​Pricing

​Video Specifications

​Tips for Better Results

Kling-Text2Video-V2-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

Pricing

Video Specifications

Tips for Better Results