# Kling v3 Turbo Pro Text to Video

> Kling 3.0 Turbo Pro text-to-video via Fal.AI. Generates high-quality 1080p video with native audio from a text prompt, with improved lip-sync and multi-shot storyboards, 3-15 seconds.

- **Provider**: fal
- **Model ID**: fal-ai/kling-video/v3/turbo/pro/text-to-video
- **Category**: video_generation
- **Credits**: from 1,630 for the default configuration — varies by input, see Pricing
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `duration` (string, optional): Video length in seconds (3-15). Billed per second. Ignored when multi_prompt is used. (Default: `5`; Options: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`)
- `enable_safety_checker` (boolean, optional): Enable the safety checker. (Default: `true`)
- `aspect_ratio` (string, optional): The aspect ratio (width:height) of the generated video. (Default: `16:9`; Options: `16:9`, `9:16`, `1:1`)
- `multi_prompt` (array, optional): Multi-shot storyboard (1-6 shots), each with its own prompt and duration; shot durations must total at most 15s. Mutually exclusive with prompt. Requests using multi_prompt are billed at the 15-second maximum regardless of the shot total.
- `prompt` (string, optional): Text prompt for the video. Keep it under 2500 characters for best results. Provide either prompt or multi_prompt (mutually exclusive).

## Example Request

```json
{
  "model": "fal-ai/kling-video/v3/turbo/pro/text-to-video",
  "input": {
    "duration": "5",
    "prompt": "A jazz saxophonist sways gently into the note, cheeks pressing, sweat glistening, smoke drifting through the warm light. The camera eases in slowly. Photorealistic, soulful, moody.",
    "aspect_ratio": "16:9"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "fal",
  "model": "fal-ai/kling-video/v3/turbo/pro/text-to-video",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null,
  "credits_used": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

When the job is `completed`, `result` holds the output URL(s) or data and `credits_used` the net credits charged. When it is `failed`, `error` and `error_code` say why and the charge is refunded.

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Pricing

Charged by input. Rules are checked top to bottom and the first match applies:

- When `multi_prompt` ≠ `[]`: 4,882.5 credits per request
- Otherwise: 325.5 credits per second (`duration`, 3–15, default 5)

Default configuration: 1,630 credits.

These are list prices. The amount charged is rounded, and large charges are discounted progressively. `POST /predictions/estimate` with the same `model` and `input` returns the charge for that input without creating a job (an estimate when the price depends on the output).

## Output Type

json

## Tags

kling, kling-v3, turbo, 1080p, text-to-video, video-generation

## Documentation

https://fal.ai/models/fal-ai/kling-video/v3/turbo/pro/text-to-video