# Kling 3.0 Pro > Kling 3.0 Text to Video (Pro) generates videos from text prompts with customizable duration, aspect ratio, and sound options. It supports multi-shot sequences and fine-tuning via CFG scale for creative video outputs. ## Overview - **Endpoint**: `https://api.higgsfield.ai/kling-video/v3.0/pro/text-to-video` - **Model ID**: `kling-video/v3.0/pro/text-to-video` - **Category**: text2video - **Kind**: inference - **Tags**: partners, commercial_use ## Pricing Standard self-serve rates in USD per video second: 1080p: $0.0962. Total price = selected rate × output duration in seconds. For explicit multi-shot requests, output duration is the sum of the shot durations. ## Authentication Keep credentials in server-side environment variables. The SDKs accept the same `KEY_ID:KEY_SECRET` value under their documented variable names. ```bash export HF_CREDENTIALS="YOUR_KEY_ID:YOUR_KEY_SECRET" # TypeScript export HF_KEY="YOUR_KEY_ID:YOUR_KEY_SECRET" # Python and cURL ``` The official SDKs configure the authorization header. Keep credentials server-side; the TypeScript SDK blocks browser use. ## API Information Use `subscribe` to submit the model request and wait for a terminal result. TypeScript performs automatic polling with `withPolling: true`; Python's synchronous `subscribe` call also waits. ### Input Parameters - **`sound`** (`string`, _optional_): - Default: `"on"` - Options: `on`, `off` - **`prompt`** (`string`, _optional_): Write your prompt here - **`duration`** (`integer`, _optional_): - Default: `5` - **`elements`** (`list`, _optional_): - **`cfg_scale`** (`number`, _optional_): - Default: `0.5` - **`multi_shots`** (`boolean`, _optional_): - Default: `false` - **`aspect_ratio`** (`string`, _optional_): - Default: `"16:9"` - Options: `16:9`, `9:16`, `1:1` - **`multi_prompt`** (`list`, _optional_): ### Input JSON Schema ```json { "type": "object", "title": "Kling 3.0 Playground", "properties": { "sound": { "enum": [ "on", "off" ], "type": "string", "title": "Generate sound", "default": "on" }, "prompt": { "type": "string", "title": "Prompt", "description": "Write your prompt here" }, "duration": { "type": "integer", "title": "Duration", "default": 5, "maximum": 15, "minimum": 3 }, "elements": { "type": "array", "items": { "type": "string" } }, "cfg_scale": { "type": "number", "title": "CFG Scale", "default": 0.5, "maximum": 1, "minimum": 0, "multipleOf": 0.01 }, "multi_shots": { "type": "boolean", "default": false }, "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1" ], "type": "string", "title": "Aspect ratio", "default": "16:9" }, "multi_prompt": { "type": "array", "items": { "type": "object", "properties": { "prompt": { "type": "string", "maxLength": 512 }, "duration": { "type": "integer", "maximum": 15, "minimum": 1 } } }, "maxItems": 6, "minItems": 0 } } } ``` ### Required Parameters Example ```json { "sound": "on", "duration": 5, "cfg_scale": 0.5, "multi_shots": false, "aspect_ratio": "16:9" } ``` ### Output Schema The shared polling endpoint returns one of the following status shapes: ```json { "title": "RequestStatus", "oneOf": [ { "title": "PendingRequestStatus", "type": "object", "properties": { "request_id": { "type": "string", "format": "uuid" }, "status_url": { "type": "string", "format": "uri" }, "cancel_url": { "type": "string", "format": "uri" }, "status": { "type": "string", "enum": [ "queued", "in_progress", "nsfw", "canceled" ] } }, "required": [ "status", "request_id" ] }, { "title": "FailedRequestStatus", "type": "object", "properties": { "request_id": { "type": "string", "format": "uuid" }, "status_url": { "type": "string", "format": "uri" }, "cancel_url": { "type": "string", "format": "uri" }, "status": { "type": "string", "const": "failed" }, "error": { "type": "string" } }, "required": [ "status", "request_id", "error" ] }, { "title": "CompletedRequestStatus", "type": "object", "properties": { "request_id": { "type": "string", "format": "uuid" }, "status_url": { "type": "string", "format": "uri" }, "cancel_url": { "type": "string", "format": "uri" }, "status": { "type": "string", "const": "completed" }, "video": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] }, "zip": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] }, "mov": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] }, "jsx": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] }, "fbx": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] }, "ply": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] } }, "required": [ "status", "request_id", "video" ] } ] } ``` ## SDK Installation Install one of the official server-side SDKs: ```bash npm install @higgsfield/client # or pip install higgsfield-client ``` ## Usage Examples ### TypeScript ```typescript import { config, higgsfield } from "@higgsfield/client/v2"; config({ credentials: process.env.HF_CREDENTIALS, }); const result = await higgsfield.subscribe( "kling-video/v3.0/pro/text-to-video", { input: { "sound": "on", "duration": 5, "cfg_scale": 0.5, "multi_shots": false, "aspect_ratio": "16:9" }, withPolling: true, }, ); console.log(result); ``` ### Python ```python import higgsfield_client result = higgsfield_client.subscribe( 'kling-video/v3.0/pro/text-to-video', arguments={'sound': 'on', 'duration': 5, 'cfg_scale': 0.5, 'multi_shots': False, 'aspect_ratio': '16:9'}, ) print(result) ``` ### cURL ```bash curl --request POST \ --url 'https://api.higgsfield.ai/kling-video/v3.0/pro/text-to-video' \ --header "Authorization: Key $HF_KEY" \ --header "Content-Type: application/json" \ --data @- <<'JSON' { "sound": "on", "duration": 5, "cfg_scale": 0.5, "multi_shots": false, "aspect_ratio": "16:9" } JSON ``` ## Additional Documentation # About **Kling 3.0 Standard** uses the model ID `kling-video/v3.0/pro/text-to-video`. Kling 3.0 Text to Video (Pro) generates videos from text prompts with customizable duration, aspect ratio, and sound options. It supports multi-shot sequences and fine-tuning via CFG scale for creative video outputs. ## 1. Calling the API Send requests to `https://api.higgsfield.ai/kling-video/v3.0/pro/text-to-video` with a JSON body matching the parameters below. ### Install Install an official server-side SDK. cURL needs no package. ```bash control=package group=install-typescript variant=npm label=npm when=javascript npm install @higgsfield/client ``` ```bash control=package group=install-python variant=pip label=pip when=python pip install higgsfield-client ``` ### Setup Keep credentials in server-side environment variables. The SDKs accept the same `KEY_ID:KEY_SECRET` value under their documented variable names. ```bash export HF_CREDENTIALS="YOUR_KEY_ID:YOUR_KEY_SECRET" # TypeScript export HF_KEY="YOUR_KEY_ID:YOUR_KEY_SECRET" # Python and cURL ``` ### Request parameters | Parameter | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `sound` | `string` | No | `"on"` | Generate sound. Options: on, off. | | `prompt` | `string` | No | `—` | Prompt. | | `duration` | `integer` | No | `5` | Duration. Minimum: 3. Maximum: 15. | | `elements` | `array[string]` | No | `—` | | | `cfg_scale` | `number` | No | `0.5` | CFG Scale. Minimum: 0. Maximum: 1. | | `multi_shots` | `boolean` | No | `false` | | | `aspect_ratio` | `string` | No | `"16:9"` | Aspect ratio. Options: 16:9, 9:16, 1:1. | | `multi_prompt` | `array[object]` | No | `—` | | ## 2. Authentication The official SDKs read credentials from the server environment and send the required `Authorization: Key KEY_ID:KEY_SECRET` header. ### API Key Never expose the secret in browser-side code or commit it to source control. The TypeScript SDK is server-side only. For direct HTTP calls, use: ```http Authorization: Key $HF_KEY ``` ## 3. Queue `subscribe` submits the asynchronous request and waits for a terminal result. The TypeScript SDK polls automatically when `withPolling: true`; the Python SDK's synchronous `subscribe` call also waits. A completed request returns the generated file in the `video` field. ### Submit and wait ```ts control=language group=submit variant=javascript label=TypeScript import { config, higgsfield } from "@higgsfield/client/v2"; config({ credentials: process.env.HF_CREDENTIALS, }); const result = await higgsfield.subscribe( "kling-video/v3.0/pro/text-to-video", { input: { "sound": "on", "duration": 5, "cfg_scale": 0.5, "multi_shots": false, "aspect_ratio": "16:9" }, withPolling: true, }, ); console.log(result); ``` ```python control=language group=submit variant=python label=Python import higgsfield_client result = higgsfield_client.subscribe( 'kling-video/v3.0/pro/text-to-video', arguments={'sound': 'on', 'duration': 5, 'cfg_scale': 0.5, 'multi_shots': False, 'aspect_ratio': '16:9'}, ) print(result) ``` ```bash control=language group=submit variant=curl label=cURL curl --request POST \ --url 'https://api.higgsfield.ai/kling-video/v3.0/pro/text-to-video' \ --header "Authorization: Key $HF_KEY" \ --header "Content-Type: application/json" \ --data @- <<'JSON' { "sound": "on", "duration": 5, "cfg_scale": 0.5, "multi_shots": false, "aspect_ratio": "16:9" } JSON ``` ### Explicit lifecycle control Use the Python SDK when a worker needs explicit status, result, or cancellation control for an existing request. The TypeScript v2 client currently exposes automatic polling through `subscribe`. ```python import higgsfield_client request_id = "{request_id}" status = higgsfield_client.status(request_id=request_id) result = higgsfield_client.result(request_id=request_id) higgsfield_client.cancel(request_id=request_id) ``` ## Additional Resources - [Model page](https://console.higgsfield.ai/models/kling-video/v3.0/pro/text-to-video) - [This LLM-readable document](https://dash.higgsfield.ai/models/kling-video/v3.0/pro/text-to-video/llms.txt?fpr=naomi-82f646)