> ## 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.

# kling-v3-text-to-video

> API usage guide for kling-v3-text-to-video.

{/* source_model_id: kling-v3-text-to-video */}

{/* source_updated_at: 1782169311 */}

**Model ID**

```bash theme={null}
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](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, per second, no audio); $0.126 (std, per second, with audio); $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

| Parameter        | Type   | Required | Description                                              |
| :--------------- | :----- | :------- | :------------------------------------------------------- |
| prompt           | string | Yes      | Describe the scene and motion (up to 2500 chars).        |
| negative\_prompt | string | No       | Elements to exclude (e.g., 'blurry, distorted').         |
| duration         | enum   | No       | Total duration in seconds (3-15). Default: "5".          |
| sound            | enum   | No       | Generate synchronized audio. Options: "on", "off".       |
| mode             | enum   | No       | Resolution of output video. Options: "std", "pro", "4k". |

## 5. Example CURL Request

```bash theme={null}
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

```bash theme={null}
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.