Skip to main content
Model ID 
kling-v3-text-to-video
Calling method: async

​
Kling T2V (v3.0) API Documentation

Kling v3.0 is a professional-grade text-to-video foundation model. It specializes in cinematic 720p generation with native audio-visual synchronization, driven purely by text prompts.

​
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

  • Pricing: 0.084(std,persecond,noaudio);0.084 (std, per second, no audio); 0.126 (std, per second, with audio); 0.168(pro,persecond,withaudio);0.168 (pro, per second, with audio); 0.42 (4k, per second)
  • Duration: 3-15 seconds
  • Resolution: Cinematic 720p/1080p/4k
  • Features: Native Audio Generation

​
3. Native Audio Generation

When ‘sound’ is enabled, the model generates synchronized ambient sound or dialogue based on the prompt. This increases the per-second rate to $0.252.

​
4. Parameter Reference

ParameterTypeRequiredDescription
promptstringYesDescribe the scene and motion (up to 2500 chars).
negative_promptstringNoElements to exclude (e.g., ‘blurry, distorted’).
durationenumNoTotal duration in seconds (3-15). Default: “5”.
soundenumNoGenerate synchronized audio. Options: “on”, “off”.
modeenumNoResolution of output video. Options: “std”, “pro”, “4k”.

​
5. Example CURL Request

curl -X POST "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 shot of a dragon taking flight from a cliffside at sunset.",
      "duration": "5",
      "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.
  • failed: Video generation failed. Check logs for details.