The Kling 3.0 series models API is now fully available Learn More Get Started Overview Quick Start Changelog API Reference General Info Rate Limits Callback Schema Video Generation Models Video Omni Text to Video Image to Video Reference to Video Motion Control Multi-elements to video Extend Video Lip Sync Avatar Text to Audio Video to Audio Text to Speech Voice Clone Image Recognize Element Effects Effect Templates NEW Video Effects Image Generation Models Image Omni Image Generation Reference to Image Extend Image AI Multi-Shot Virtual Try-On Others Query user info Pricing Billing Info Prepaid Resource Packs Protocols Privacy Policy of API Service Terms of API Service API Service Level Agreement Omni-Image Create Task POST /v1/images/omni-image cURL Copy Collapse curl --request POST \ --url https://api-singapore.klingai.com/v1/images/omni-image \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "model_name": "kling-image-o1", "prompt": "Merge all the people in the images into the <<>> image", "element_list": [ { "element_id": 829836802793406551 } ], "image_list": [ { "image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-4.png" }, { "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/1.png" }, { "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/video_effects/4.png" } ], "resolution": "2k", "n": 1, "aspect_ratio": "3:2" }' 200 Copy Collapse { "code": 0, // Error code; Specific definitions can be found in Error codes "message": "string", // Error message "request_id": "string", // Request ID, system-generated, used for tracking requests and troubleshooting "data": { "task_id": "string", // Task ID, system-generated "task_info": { //Task creation parameters "external_task_id": "string" //User-defined task ID }, "task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed "created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms "updated_at": 1722769557708 //Task update time, Unix timestamp, unit: ms } } Request Header Content-Type string Required Default to application/json Data Exchange Format Authorization string Required Authentication information, refer to API authentication Request Body model_name string Optional Default to kling-image-o1 Model Name Enum values： kling-image-o1 kling-v3-omni prompt string Required Text prompt words, which can include positive and negative descriptions The prompt words can be templated to meet different image generation needs Must not exceed 2,500 characters Specify an image in the format of <<<>>>, such as <<>> The scope of abilities can be found in the user manual: KLING Omni Model User Guide image_list array Optional Reference Image List Load with key:value format as follows: "image_list":[ { "image":"image_url" } ] Supports inputting image Base64 encoding or image URL (ensure accessibility) Supported image formats: .jpg / .jpeg / .png Image file size must not exceed 10MB. Image dimensions must be at least 300px. Aspect ratio must be between 1:2.5 and 2.5:1 The sum of reference elements and reference images must not exceed 10 The value of image_url parameter must not be empty ▾ Hide child attributes image string Required Image URL or Base64 string element_list array Optional Reference Element List based on element ID configuration Load with key:value format as follows: "element_list":[ { "element_id": 829836802793406551 } ] The sum of reference elements and reference images must not exceed 10 The support range for different model versionsvaries. For details, see Capability Map ▾ Hide child attributes element_id long Required Element ID from element library resolution string Optional Default to 1k Image generation resolution Enum values： 1k 2k 4k 1k: 1K standard definition 2k: 2K high-res 4k: 4K high-res The support range for different model versionsvaries. For details, see Capability Map result_type string Optional Default to single Control whether to generate a single image or a series of images Enum values： single series The support range for different model versionsvaries. For details, see Capability Map n int Optional Default to 1 Number of generated images Value range: [1, 9] When result_type is series, this parameter is invalid series_amount int Optional Default to 4 Number of images in a series Value range: [2, 9] When result_type is single, this parameter is invalid The support range for different model versionsvaries. For details, see Capability Map aspect_ratio string Optional Default to auto Aspect ratio of the generated images (width:height) Enum values： 16:9 9:16 1:1 4:3 3:4 3:2 2:3 21:9 auto auto is to intelligently aspect ratio of the generated image based on incoming content. When generating a new image based on the aspect ratio of the original image, this parameter is invalid The support range for different model versionsvaries. For details, see Capability Map watermark_info object Optional Whether to generate watermarked results simultaneously Defined by the enabled parameter, format: "watermark_info": { "enabled": boolean } true: generate watermarked result, false: do not generate Custom watermarks are not currently supported callback_url string Optional The callback notification address for the result of this task. If configured, the server will actively notify when the task status changes For the specific message schema, see Callback Protocol external_task_id string Optional Customized Task ID User-defined task ID. It will not override the system-generated task ID, but supports querying tasks by this ID Please note that it must be unique for each user Invocation examples Image generation with element curl --location 'https://xxx/v1/images/generations' \ --header 'Authorization: Bearer xxx' \ --header 'Content-Type: application/json' \ --data '{ "model_name": "kling-v3-omni", "prompt": "Generate a recommended cover for each subject <> based on the style of the reference image <>", "element_list": [ { "element_id": "160" }, { "element_id": "161" } ], "image_list": [ { "image": "xxx" }, { "image": "xxx" } ], "resolution": "2k", "result_type": "series", "series_amount": 2, "aspect_ratio": "auto", "external_task_id": "", "callback_url": "" }' Query Task (Single) GET /v1/images/omni-image/{id} cURL Copy Collapse curl --request GET \ --url https://api-singapore.klingai.com/v1/images/omni-image/{id} \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' 200 Copy Collapse { "code": 0, // Error codes; specific definitions see Error codes "message": "string", // Error information "request_id": "string", // Request ID, generated by the system, for tracking and troubleshooting "data": { "task_id": "string", // Task ID, generated by the system "task_status": "string", // Task status: submitted, processing, succeed, failed "task_status_msg": "string", // Task status message, failure reason when task fails "task_info": { //Task creation parameters "external_task_id": "string" //Customer-defined task ID }, "task_result": { "result_type": "single", "images": [ { "index": 0, // Image number "url": "string", // URL for generated image, anti-hotlinking format (Generated images/videos will be cleared after 30 days. Please save promptly.) "watermark_url": "string" // Watermarked image download URL, anti-hotlinking format } ], "series_images": [ { "index": 0, // Series-image sequence number "url": "string", // URL for generated image, anti-hotlinking format "watermark_url": "string" // Watermarked image download URL } ] }, "watermark_info": { "enabled": boolean }, "final_unit_deduction": "string", // Final unit deduction for the task "created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms "updated_at": 1722769557708 //Task update time, Unix timestamp, unit: ms } } Request Header Content-Type string Required Default to application/json Data Exchange Format Authorization string Required Authentication information, refer to API authentication Path Parameters task_id string Required The task ID for image generation. Request path parameter, directly fill the value in the request path. Query by external_task_id or task_id. external_task_id string Optional Customized Task ID for audio generation The external_task_id filled in when creating the task. You can choose to query by external_task_id or task_id When creating a task, you can choose to query by external_task_id or task_id. Query Task (List) GET /v1/images/omni-image cURL Copy Collapse curl --request GET \ --url 'https://api-singapore.klingai.com/v1/images/omni-image?pageNum=1&pageSize=30' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' 200 Copy Collapse { "code": 0, // Error codes; specific definitions see Error codes "message": "string", // Error information "request_id": "string", // Request ID, generated by the system "data": [ { "task_id": "string", // Task ID, generated by the system "task_status": "string", // Task status: submitted, processing, succeed, failed "task_status_msg": "string", // Task status message "task_info": { //Task creation parameters "external_task_id": "string" //Customer-defined task ID }, "final_unit_deduction": "string", // Final unit deduction for the task "created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms "updated_at": 1722769557708, // Task update time, Unix timestamp, unit: ms "watermark_info": { "enabled": boolean }, "task_result": { "result_type": "single", "images": [ { "index": 0, // Image number "url": "string", // URL for generated image, anti-hotlinking format (Generated images/videos will be cleared after 30 days. Please save promptly.) "watermark_url": "string" // Watermarked image download URL } ], "series_images": [ { "index": 0, // Series-image sequence number "url": "string", // URL for generated image, anti-hotlinking format "watermark_url": "string" // Watermarked image download URL } ] } } ] } Request Header Content-Type string Required Default to application/json Data Exchange Format Authorization string Required Authentication information, refer to API authentication Query Parameters pageNum int Optional Default to 1 Page number Value range: [1, 1000] pageSize int Optional Default to 30 Number of items per page Value range: [1, 500] Previous chapter：Models Next chapter：Image Generation Create Task Invocation examples Query Task (Single) Query Task (List) The Kling 3.0 Series Models API is Now Fully Available – All in One, One for All！ Models Available in This Release Kling 3.0 Motion Control, Kling Video 3.0, Kling Video 3.0 Omni, Kling Image 3.0, Kling Image 3.0 Omni Refer to Key Highlights of the Models 3.0 All-in-One: A unified model for multi-modal input and output. Most powerful consistency across the universe: Subject consistency (supports cameo, subject with voice control, i2v + subject) and text consistency. Narrative control at your fingertips: More freedom, precision, and control—up to 15 seconds long, video scene cuts, ultra-high-definition storyboards/images, custom seconds. Upgraded native audio-visual output: Supports multiple speakers and languages (with accents). Kling 3.0 Motion Control Consistent Facial Identity from any angle Complex Emotions faithfully reproduced High fidelity Restoration, Even with Face Occlusions Consistent Facial Clarity Across Dynamic Framing User Guide -> Kling Video 3.0 Compared to 2.6, expected improvements: Supports subject upload in I2V scenarios for enhanced consistency Significant improvement in multi-character referencing, especially for three-person scenarios Supports Japanese, Korean, and Spanish in addition to Chinese and English Capable of generating certain dialects and accents Better distinction and control over different types of audio (speech, sound effects, BGM) Improved text retention in I2V scenarios Supports scene transitions, with up to 6 shots and customizable storyboarding User Guide -> Kling Video 3.0 Omni Compared to O1, expected improvements: Native audio-visual synchronization Supports video subject creation Further improved consistency in reference-based tasks, especially for characters and products Combined capabilities of reference + storyboarding + audio-visual sync significantly enhance usability Supports scene transitions, with up to 6 shots Extended generation duration up to 15 seconds User Guide -> Kling Image 3.0 Highly consistent feature retention Precise response to detail modifications Accurate control over style and tone Rich imaginative capabilities User Guide -> Kling Image 3.0 Omni Enhanced narrative sense New storyboard image set generation, retaining reference image features with scene relevance Direct output of 2K/4K ultra-high-definition images Further improved detail consistency User Guide -> Thank you for your support and understanding! I Got It