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-v3-text-to-video

​
Kling T2V (v3.0) API Documentation

Kling v3.0 Text-to-Video is a professional-grade foundation model that produces cinematic 720p videos. It features high motion consistency, native audio generation, and support for multiple aspect ratios.

​
1. API Endpoint & Authentication

Base URL: https://console.gmicloud.ai Endpoint: POST /api/v1/ie/requestqueue/apikey/requests Header: Authorization: Bearer YOUR_API_KEY Content-Type: application/json

​
2. Model Specifications

  • Duration: 3-15 seconds
  • Resolution: Cinematic 720p
  • Features: Native Audio, Variable Aspect Ratios, High Motion Consistency

​
3. Core Logic

​
Aspect Ratio Support

Unlike I2V, the T2V model allows you to specify the frame shape (16:9, 9:16, or 1:1) to match your target platform, such as YouTube, TikTok, or Instagram.

​
Native Audio Generation

When ‘sound’ is enabled, the model generates synchronized ambient sound or dialogue based on the prompt. ## 4. Parameter Reference
ParameterTypeRequiredDescription
promptstringYesPrimary text prompt describing the video scene and action.
negative_promptstringNoElements to exclude (e.g., ‘blurry, low quality’).
durationenumNoTotal duration in seconds (3-15). Default: “5”.
aspect_ratioenumNoOptions: “16:9”, “9:16”, “1:1”. Default: “16:9”.
soundenumNoGenerate synchronized audio. Options: “on”, “off”.

​
5. Example CURL Request

curl -X POST "[https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests](https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests)" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3-text-to-video",
    "payload": {
      "prompt": "A cinematic wide shot of an astronaut walking through a futuristic bioluminescent forest on a distant planet.",
      "duration": "5",
      "aspect_ratio": "16:9",
      "sound": "on"
    }
  }'

​
6. Checking Request Status

Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
  • queued: Request is waiting to be processed by GPU resources.
  • processing: Video generation is currently in progress.
  • success: Generation completed. URLs available in outcome.media_urls.