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 Multi-Image to Image Create Task POST /v1/images/multi-image2image cURL Copy Collapse curl --request POST \ --url https://api-singapore.klingai.com/v1/images/multi-image2image \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "model_name": "kling-v2-1", "prompt": "Wearing a flowing red dress on the grassland, in Ghibli style.", "negative_prompt": "", "subject_image_list": [ { "subject_image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png" }, { "subject_image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-2.png" } ], "scene_image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/background.jpeg", "style_image": "https://v1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/16x9_jipuli.png", "n": 2, "aspect_ratio": "9:16" }' 200 Copy Collapse { "code": 0, // Error code; Specific definitions can be found in "Error Code" "message": "string", // Error message "request_id": "string", // Request ID, generated by the system, used for tracking requests and troubleshooting "data": { "task_id": "string", // Task ID, generated by the system "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 } } Generate images based on multiple reference images (subject, scene, style). 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-v2 Model Name Enum values： kling-v2 kling-v2-1 prompt string Optional Positive text prompt Cannot exceed 2500 characters subject_image_list array Required Subject Reference Images Support up to 4 images, at least 1 image, using key:value format as follows: "subject_image_list":[ { "subject_image":"image_url" }, { "subject_image":"image_url" }, { "subject_image":"image_url" }, { "subject_image":"image_url" } ] The API does not perform cropping, please upload images with subjects already cropped Supports image input as either Base64-encoded string or URL (ensure the URL is publicly accessible) Important: When using Base64, do NOT add any prefix like data:image/png;base64,. Submit only the raw Base64 string. Correct Base64 format: iVBORw0KGgoAAAANSUhEUgAAAAUA... Incorrect Base64 format (with data: prefix): data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA... Supported image formats: .jpg / .jpeg / .png Image file size must not exceed 10MB. Image dimensions must be at least 300px in width and height. Aspect ratio must be between 1:2.5 and 2.5:1 ▾ Hide child attributes subject_image string Required Subject image URL or Base64 string scene_image string Optional Scene Reference Image Supports image input as either Base64-encoded string or URL (ensure the URL is publicly accessible) Important: When using Base64, do NOT add any prefix like data:image/png;base64,. Submit only the raw Base64 string. Correct Base64 format: iVBORw0KGgoAAAANSUhEUgAAAAUA... Incorrect Base64 format (with data: prefix): data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA... Supported image formats: .jpg / .jpeg / .png Image file size must not exceed 10MB. Image dimensions must be at least 300px in width and height. Aspect ratio must be between 1:2.5 and 2.5:1 style_image string Optional Style Reference Image Supports image input as either Base64-encoded string or URL (ensure the URL is publicly accessible) Important: When using Base64, do NOT add any prefix like data:image/png;base64,. Submit only the raw Base64 string. Correct Base64 format: iVBORw0KGgoAAAANSUhEUgAAAAUA... Incorrect Base64 format (with data: prefix): data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA... Supported image formats: .jpg / .jpeg / .png Image file size must not exceed 10MB. Image dimensions must be at least 300px in width and height. Aspect ratio must be between 1:2.5 and 2.5:1 n int Optional Default to 1 Number of generated images Value range: [1, 9] aspect_ratio string Optional Default to 16:9 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 The support range for different model versions varies. 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 The specific message schema of the notification can be found in 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 Query Task (Single) GET /v1/images/multi-image2image/{id} cURL Copy Collapse curl --request GET \ --url https://api-singapore.klingai.com/v1/images/multi-image2image/{id} \ --header 'Authorization: Bearer ' 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_info": { //Task creation parameters "external_task_id": "string" //Customer-defined task ID }, "task_status": "string", // Task status: submitted, processing, succeed, failed "task_status_msg": "string", // Task status message, failure reason when task fails "final_unit_deduction": "string", // Final unit deduction for the task "watermark_info": { "enabled": boolean }, "created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms "updated_at": 1722769557708, // Task update time, Unix timestamp, unit: ms "task_result": { "images": [ { "index": 0, // Image number, 0-9 "url": "string", // URL for generated image (Generated images/videos will be cleared after 30 days. Please save promptly.) "watermark_url": "string" // Watermarked image download URL, anti-hotlinking format } ] } } } 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/multi-image2image cURL Copy Collapse curl --request GET \ --url 'https://api-singapore.klingai.com/v1/images/multi-image2image?pageNum=1&pageSize=30' \ --header 'Authorization: Bearer ' 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_info": { //Task creation parameters "external_task_id": "string" //Customer-defined task ID }, "task_status": "string", // Task status: submitted, processing, succeed, failed "task_status_msg": "string", // Task status message "final_unit_deduction": "string", // Final unit deduction for the task "watermark_info": { "enabled": true }, "created_at": 1722769557708, // Task creation time, Unix timestamp, unit: ms "updated_at": 1722769557708, // Task update time, Unix timestamp, unit: ms "task_result": { "images": [ { "index": 0, // Image number, 0-9 "url": "string", // URL for generated image (Generated images/videos will be cleared after 30 days. Please save promptly.) "watermark_url": "string" // Watermarked image download URL, anti-hotlinking format } ] } } ] } 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：Image Generation Next chapter：Extend Image Create Task 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