## Basic model info - Model name: kling/kling kling-v3-4k-fal - Model description: Kling 3.0 Native 4K via fal: cinematic text/image-to-video with direct 4K output. - Endpoint name: text-to-video ## Model schema The model schema is defined in the OpenAPI schema: [OpenAPI Schema](https://oapi.sunra.ai/main/kling/kling-v3-4k-fal/latest.json) ### Model input schema The model input schema is: ```json { "description": "Input model for text-to-video generation.", "properties": { "prompt": { "anyOf": [ { "maxLength": 2500, "type": "string" }, { "type": "null" } ], "description": "Text prompt for video generation. Either prompt or multi_prompt must be provided, not both.", "title": "Prompt", "x-sr-order": 201 }, "aspect_ratio": { "default": "16:9", "description": "Aspect ratio of the generated video", "enum": [ "16:9", "9:16", "1:1" ], "title": "Aspect Ratio", "type": "string", "x-sr-order": 401 }, "negative_prompt": { "anyOf": [ { "maxLength": 2500, "type": "string" }, { "type": "null" } ], "default": "blur, distort, and low quality", "description": "Negative prompt to specify what you do not want in the generated video", "title": "Negative Prompt", "x-sr-order": 203 }, "cfg_scale": { "default": 0.5, "description": "CFG scale - how closely to follow the prompt (0-1)", "maximum": 1, "minimum": 0, "title": "Cfg Scale", "type": "number", "x-sr-order": 405 }, "duration": { "default": "5", "description": "Duration of the video in seconds", "enum": [ "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "title": "Duration", "type": "string", "x-sr-order": 402 }, "generate_audio": { "default": true, "description": "Whether to generate native audio for the video", "title": "Generate Audio", "type": "boolean", "x-sr-order": 403 }, "multi_prompt": { "anyOf": [ { "items": { "description": "Element for multi-shot video generation.", "properties": { "prompt": { "description": "The prompt for this shot", "title": "Prompt", "type": "string" }, "duration": { "default": "5", "description": "The duration of this shot in seconds", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "title": "Duration", "type": "string" } }, "required": [ "prompt" ], "title": "MultiPromptElement", "type": "object" }, "type": "array" }, { "type": "null" } ], "description": "Multi-shot prompts for multi-shot video generation. Overrides single prompt.", "title": "Multi Prompt", "x-sr-order": 202 }, "shot_type": { "default": "customize", "description": "Type of multi-shot video generation", "enum": [ "customize", "intelligent" ], "title": "Shot Type", "type": "string", "x-sr-order": 404 } }, "title": "TextToVideoInput", "type": "object" } ``` ### Model output schema The model output schema is: ```json { "properties": { "video": { "properties": { "content_type": { "description": "The mime type of the file.", "title": "Content Type", "type": "string" }, "file_name": { "description": "The name of the file. It will be auto-generated if not provided.", "title": "File Name", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "title": "File Size", "type": "integer" }, "url": { "description": "The URL where the file can be downloaded from.", "title": "Url", "type": "string" } }, "required": [ "content_type", "file_name", "file_size", "url" ], "title": "SunraFile", "type": "object" } }, "required": [ "video" ], "title": "VideoOutput", "type": "object" } ``` ## Example inputs and outputs Use the following example inputs and outputs to understand the model. ### Input example ```json { "prompt": null, "aspect_ratio": "16:9", "negative_prompt": "blur, distort, and low quality", "cfg_scale": 0.5, "duration": "5", "generate_audio": true, "multi_prompt": null, "shot_type": "customize" } ``` ### Output example ```json { } ``` ## Model code examples ### JavaScript ```javascript import { sunra } from "@sunra/client"; const result = await sunra.subscribe("kling/kling-v3-4k-fal/text-to-video", { input: { prompt: null, multi_prompt: null, negative_prompt: 'blur, distort, and low quality', aspect_ratio: '16:9', duration: '5', generate_audio: true, shot_type: 'customize', cfg_scale: 0.5 }, logs: true, onQueueUpdate: (update) => { console.log(`Status Update: ${update.status}, Request ID: ${update.request_id}`); }, }); console.log(result.data); console.log(result.requestId); ``` ### Python ```python import sunra_client result = sunra_client.subscribe( "kling/kling-v3-4k-fal/text-to-video", arguments={ "prompt": None, "multi_prompt": None, "negative_prompt": "blur, distort, and low quality", "aspect_ratio": "16:9", "duration": "5", "generate_audio": True, "shot_type": "customize", "cfg_scale": 0.5 }, with_logs=True, on_enqueue=print, on_queue_update=print, ) print(result) ``` ### Java ```java import ai.sunra.client.*; import java.util.Map; import com.google.gson.JsonObject; var client = SunraClient.withEnvCredentials(); var response = client.subscribe( "kling/kling-v3-4k-fal/text-to-video", SubscribeOptions.builder() .input(Map.of( "prompt", null, "multi_prompt", null, "negative_prompt", "blur, distort, and low quality", "aspect_ratio", "16:9", "duration", "5", "generate_audio", true, "shot_type", "customize", "cfg_scale", 0.5)) .resultType(JsonObject.class) .onQueueUpdate(update -> System.out.printf( "\nStatus Update: %s, Request ID: %s%n", update.getStatus(), update.getRequestId() )) .logs(true) .build() ); System.out.println("Completed!"); System.out.println(response.getData()); ``` ### Kotlin ```kotlin import ai.sunra.client.kt.* import com.google.gson.JsonObject val client = createSunraClient() val response = client.subscribe( endpointId = "kling/kling-v3-4k-fal/text-to-video", input = mapOf( "prompt" to null, "multi_prompt" to null, "negative_prompt" to "blur, distort, and low quality", "aspect_ratio" to "16:9", "duration" to "5", "generate_audio" to true, "shot_type" to "customize", "cfg_scale" to 0.5), options = ai.sunra.client.kt.SubscribeOptions(logs = true), onUpdate = { update -> println("\nStatus Update: ${update.status}, Request ID: ${update.requestId}") } ) println("Completed!") println(response.data) ``` ### Curl ```bash curl --request POST \ --url https://api.sunra.ai/v1/queue/kling/kling-v3-4k-fal/text-to-video \ --header "Authorization: Key $SUNRA_KEY" \ --header "Content-Type: application/json" \ --data '{"prompt":null,"multi_prompt":null,"negative_prompt":"blur, distort, and low quality","aspect_ratio":"16:9","duration":"5","generate_audio":true,"shot_type":"customize","cfg_scale":0.5}' ``` ## Model readme >