# Kling 3.0 Pro Text-to-Video

> Kling 3.0 generates cinematic 1080p videos with realistic audio and structured storytelling.


## Overview

- **Endpoint**: `https://api.segmind.com/v1/kling-3-pro-text2video`
- **Model ID**: `kling-3-pro-text2video`
- **Category**: Text-to-Video Generation
- **Type**: Synchronous (Direct response)

- **Average Cost**: $1.5087058823529411


## Pricing

| duration | generate_audio | has_voice_ids | cost |
| --- | --- | --- | --- |
| 3 | false | false | 0.672 |
| 3 | true | false | 1.008 |
| 3 | true | true | 2.184 |
| 4 | false | false | 0.896 |
| 4 | true | false | 1.344 |
| 4 | true | true | 2.912 |
| 5 | false | false | 1.12 |
| 5 | true | false | 1.68 |
| 5 | true | true | 3.64 |
| 6 | false | false | 1.344 |
| 6 | true | false | 2.016 |
| 6 | true | true | 4.368 |
| 7 | false | false | 1.568 |
| 7 | true | false | 2.352 |
| 7 | true | true | 5.096 |
| 8 | false | false | 1.792 |
| 8 | true | false | 2.688 |
| 8 | true | true | 5.824 |
| 9 | false | false | 2.016 |
| 9 | true | false | 3.024 |
| 9 | true | true | 6.552 |
| 10 | false | false | 2.24 |
| 10 | true | false | 3.36 |
| 10 | true | true | 7.28 |
| 11 | false | false | 2.464 |
| 11 | true | false | 3.696 |
| 11 | true | true | 8.008 |
| 12 | false | false | 2.688 |
| 12 | true | false | 4.032 |
| 12 | true | true | 8.736 |
| 13 | false | false | 2.912 |
| 13 | true | false | 4.368 |
| 13 | true | true | 9.464 |
| 14 | false | false | 3.136 |
| 14 | true | false | 4.704 |
| 14 | true | true | 10.192 |
| 15 | false | false | 3.36 |
| 15 | true | false | 5.04 |
| 15 | true | true | 10.92 |

## API Information

This model uses a **synchronous response pattern**:
1. Make a POST request with your parameters
2. Receive the output directly in the response (binary for images/videos/audio, JSON for text)
3. No polling required - response is immediate


### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Prompt
  Describe the video content. Be detailed about actions, camera movements, lighting.

- **`duration`** (`string`, _optional_):
  Duration (seconds)
  Length of the output video in seconds.
  - Default: `"5"`
  - Options: "3" (3), "4" (4), "5" (5), "6" (6), "7" (7), "8" (8), "9" (9), "10" (10), "11" (11), "12" (12), "13" (13), "14" (14), "15" (15)

- **`cfg_scale`** (`number`, _optional_):
  CFG Scale
  Prompt adherence strength. Higher values follow the prompt more closely.
  - Default: `0.5`
  - Range: 0 to 1

- **`shot_type`** (`string`, _optional_):
  Shot Type
  Camera shot type.
  - Default: `"customize"`

- **`voice_ids`** (`array`, _optional_):
  Voice IDs
  Voice IDs for audio. Reference in prompt as <<<voice_1>>>, <<<voice_2>>>. Max 2. Get voice IDs from the Kling Create Voice endpoint: https://www.segmind.com/models/kling-create-voice
  - Item type: string

- **`aspect_ratio`** (`string`, _optional_):
  Aspect Ratio
  Aspect ratio of the generated video.
  - Default: `"16:9"`
  - Options: "16:9" (16:9), "9:16" (9:16), "1:1" (1:1)

- **`multi_prompt`** (`array`, _optional_):
  Multi Prompt
  Multi-shot video generation. Each segment has its own prompt and duration. Max 5 segments.
  - Item type: object

- **`generate_audio`** (`boolean`, _optional_):
  Generate Audio
  Generate synchronized audio. Supports Chinese and English.
  - Default: `true`

- **`negative_prompt`** (`string`, _optional_):
  Negative Prompt
  Specify elements to avoid. E.g. blur, distort, low quality.
  - Default: `"blur, distort, and low quality"`


**Required Parameters Example**:

```json
{
  "prompt": "Slow cinematic push-in through an empty ancient temple. Fog drifts lazily through the valley below. Golden light catches dust particles floating between stone pillars."
}
```


**Full Example**:

```json
{
  "prompt": "Slow cinematic push-in through an empty ancient temple. Fog drifts lazily through the valley below. Golden light catches dust particles floating between stone pillars.",
  "duration": "5",
  "cfg_scale": 0.5,
  "shot_type": "customize",
  "voice_ids": [],
  "aspect_ratio": "16:9",
  "multi_prompt": [],
  "generate_audio": true,
  "negative_prompt": "blur, distort, and low quality"
}
```


### Output Schema

The API returns a synchronous response based on the model type:

**For Image/Video/Audio Models**:
- Response contains binary data (image/png, video/mp4, audio/mp3)
- Content-Type header indicates the media type
- Save the response body directly to a file

**For Text Models**:
- Response is JSON with the generated text
- Structure varies by model

**HTTP Response Codes**:
- **200 - OK**: Request successful, output in response body
- **400 - Bad Request**: Invalid parameters
- **401 - Unauthorized**: Invalid or missing API key
- **404 - Not Found**: Model not found
- **406 - Not Acceptable**: Insufficient credits
- **429 - Too Many Requests**: Rate limit exceeded
- **500 - Server Error**: Internal server error


## Usage Examples

### cURL

```bash
curl -X POST "https://api.segmind.com/v1/kling-3-pro-text2video" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Slow cinematic push-in through an empty ancient temple. Fog drifts lazily through the valley below. Golden light catches dust particles floating between stone pillars.",
  "duration": "5",
  "cfg_scale": 0.5,
  "shot_type": "customize",
  "voice_ids": [],
  "aspect_ratio": "16:9",
  "multi_prompt": [],
  "generate_audio": true,
  "negative_prompt": "blur, distort, and low quality"
}'
```

### Python

```python
import requests
import json

api_key = "YOUR_API_KEY"
url = "https://api.segmind.com/v1/kling-3-pro-text2video"

data = {
  "prompt": "Slow cinematic push-in through an empty ancient temple. Fog drifts lazily through the valley below. Golden light catches dust particles floating between stone pillars.",
  "duration": "5",
  "cfg_scale": 0.5,
  "shot_type": "customize",
  "voice_ids": [],
  "aspect_ratio": "16:9",
  "multi_prompt": [],
  "generate_audio": true,
  "negative_prompt": "blur, distort, and low quality"
}

response = requests.post(
    url,
    json=data,
    headers={
        'x-api-key': api_key,
        'Content-Type': 'application/json'
    }
)

if response.status_code == 200:
    # For image/video/audio models, response.content contains the binary data
    with open('output.png', 'wb') as f:
        f.write(response.content)
    print('Generation complete, saved to output.png')
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

### JavaScript

```javascript
const apiKey = 'YOUR_API_KEY';
const url = 'https://api.segmind.com/v1/kling-3-pro-text2video';

const data = {
  "prompt": "Slow cinematic push-in through an empty ancient temple. Fog drifts lazily through the valley below. Golden light catches dust particles floating between stone pillars.",
  "duration": "5",
  "cfg_scale": 0.5,
  "shot_type": "customize",
  "voice_ids": [],
  "aspect_ratio": "16:9",
  "multi_prompt": [],
  "generate_audio": true,
  "negative_prompt": "blur, distort, and low quality"
};

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'x-api-key': apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(data),
});

if (response.ok) {
  // For image/video/audio models, response contains binary data
  const blob = await response.blob();
  const downloadUrl = URL.createObjectURL(blob);

  // Create download link
  const a = document.createElement('a');
  a.href = downloadUrl;
  a.download = 'output.png';
  a.click();

  console.log('Generation complete');
}
```


## Additional Resources

### Documentation

- [Model Playground](https://www.segmind.com/models/kling-3-pro-text2video)
- [API Documentation](https://www.segmind.com/models/kling-3-pro-text2video/api)
- [Pricing Details](https://www.segmind.com/models/kling-3-pro-text2video/pricing)
- [Platform Documentation](https://docs.segmind.com/)

### Tags

No tags available