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 Video Create Task POST /v1/videos/multi-image2video cURL Copy Collapse curl --request POST \ --url https://api-singapore.klingai.com/v1/videos/multi-image2video \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "model_name": "kling-v1-6", "image_list": [ { "image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog.png" }, { "image": "https://p1-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dog_cloth.png" } ], "prompt": "A white Bichon Frise wearing a red Northeast-style floral cotton jacket, licking its paw", "negative_prompt": "", "mode": "pro", "duration": "5", "aspect_ratio": "16:9", "callback_url": "", "external_task_id": "" }' 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 to track requests and troubleshoot problems "data": { "task_id": "string", // Task ID, generated by the system "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 video from multiple reference images (elements). 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-v1-6 Model Name Enum values： kling-v1-6 image_list array Required Reference Image List Support up to 4 images, load with key:value format as follows: "image_list":[ { "image":"image_url" }, { "image":"image_url" }, { "image":"image_url" }, { "image":"image_url" } ] Please directly upload the image with selected subject since there is no cropping logic on the API side 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. Aspect ratio must be between 1:2.5 and 2.5:1 ▾ Hide child attributes image string Required Image URL or Base64 string prompt string Required Positive text prompt Cannot exceed 2500 characters negative_prompt string Optional Negative text prompt Cannot exceed 2500 characters mode string Optional Default to std Video generation mode Enum values： std pro std: Standard Mode, which is cost-effective pro: Professional Mode, generates higher quality video output Different model versions and video modes have different support ranges. For details, see Capability Map duration string Optional Default to 5 Video Length, unit: s (seconds) Enum values： 5 10 aspect_ratio string Optional Default to 16:9 The aspect ratio of the generated video frame (width:height) Enum values： 16:9 9:16 1:1 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/videos/multi-image2video/{id} cURL Copy Collapse curl --request GET \ --url https://api-singapore.klingai.com/v1/videos/multi-image2video/{task_id} \ --header 'Authorization: Bearer ' 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 to track requests and troubleshoot problems "data": { "task_id": "string", // Task ID, generated by the system "task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed "task_status_msg": "string", // Task status message, displays failure reason when task fails (such as content moderation triggers) "task_info": { //Task creation parameters "external_task_id": "string" //User-defined task ID }, "task_result": { "videos": [ { "id": "string", // Generated video ID; globally unique "url": "string", // URL for generating videos (Please note that for security purposes, generated images/videos will be deleted after 30 days. Please save them promptly.) "watermark_url": "string", // Watermarked video download URL, anti-hotlinking format "duration": "string" //Total video duration, unit: s (seconds) } ] }, "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 Optional Task ID for Multi-Image to Video Request path parameter, fill the value directly in the request path You can choose to query by external_task_id or task_id external_task_id string Optional Customized Task ID for Multi-Image to Video Request path parameter, fill the value directly in the request path The external_task_id filled in when creating the task. You can choose to query by external_task_id or task_id Query Task (List) GET /v1/videos/multi-image2video cURL Copy Collapse curl --request GET \ --url 'https://api-singapore.klingai.com/v1/videos/multi-image2video?pageNum=1&pageSize=30' \ --header 'Authorization: Bearer ' 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 to track requests and troubleshoot problems "data": [ { "task_id": "string", // Task ID, generated by the system "task_status": "string", // Task status, Enum values: submitted, processing, succeed, failed "task_status_msg": "string", // Task status message, displays failure reason when task fails (such as content moderation triggers) "task_info": { //Task creation parameters "external_task_id": "string" //User-defined task ID }, "task_result": { "videos": [ { "id": "string", // Generated video ID; globally unique "url": "string", // URL for generating videos (Please note that for security purposes, generated images/videos will be deleted after 30 days. Please save them promptly.) "watermark_url": "string", // Watermarked video download URL, anti-hotlinking format "duration": "string" //Total video duration, unit: s (seconds) } ] }, "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 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 to Video Next chapter：Motion Control 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