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 Element Create Element POST /v1/general/advanced-custom-elements 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_info": { //Task creation parameters "external_task_id": "string" //Customer-defined task ID }, "task_status": "string", //Task status: submitted, processing, succeed, failed "created_at": 1722769557708, //Task creation time, Unix timestamp, ms "updated_at": 1722769557708 //Task update time, Unix timestamp, ms } } 💡 The service related to creating entities has been upgraded to a brand new version. If you need to browse the old version, please proceed to:Kling AI (OLD VERSION) ELEMENTS API Specification Request Header Content-Type string Required Default to application/json Data Exchange Format Authorization string Required Authentication information, refer to API authentication Request Body element_name string Required Element Name Must not exceed 20 characters. element_description string Required Element Description Must not exceed 100 characters. reference_type string Required Reference Method Enum values： video_refer image_refer video_refer: Video Character Elements, at this time, the subject's appearance will be defined with reference to element_video_list. image_refer: Multi-Image Elements, whose appearance will be defined with reference to the element_image_list. The scope of availability differs between entities customized through videos and those customized through images. Please refer to the capability map and parameter specifications for details. element_image_list object Optional Default to None The main reference image allows for the setting of the element and its details through multiple images. Include front reference images and reference images from other angles or close-ups: at least one frontal reference image (frontal_image), and 1 to 3 additional reference images (image_url) that differ from the front. Load with key:value format as follows: "element_image_list": { "frontal_image": "image_url_0", "refer_images": [{ "image_url": "image_url_1" }, ...] } Supports inputting image Base64 encoding or image URL (ensure accessibility). Supported image formats: .jpg / .jpeg / .png. Image file size cannot exceed 10MB, dimensions not less than 300px, aspect ratio between 1:2.5 ~ 2.5:1. When reference_type is image_refer, this parameter is required. element_video_list object Optional Default to None The element is referenced by the video, and its details can be set through the video. Audio videos can be uploaded. If the audio video contains human voice, it will trigger voice customization (customization + inclusion in voice library + binding with the element). Currently, only realistic-style humanoid figures can be customized through video. Required when referencing videos; invalid when referencing images. Structure: element_video_list: { refer_videos: [{ video_url: "video_url_1" }] }. Only .mp4/.mov formats. Duration 3s–8s, 1080P, aspect ratio 16:9 or 9:16. At most 1 video, size not exceeding 200MB. video_url must not be empty. "element_video_list": { "refer_videos": [{ "video_url": "video_url_1" }, ...] } Video-customized elements are only supported for kling-video-o3 and later models. element_voice_id string Optional Default to None The voice ID of element can be bound to existing tone colors in the tone library When the current parameter is empty, the current entity is not bound to a tone color. The ID can be obtained through the voice-related API. For details, see Voice Guide tag_list array Optional Default to None Configure tags for the subject, one subject can configure multiple tags. Structure: tag_list: [{ tag_id: "o_101" }, { tag_id: "o_102" }, ...]. Tag ID and name: o_101 Hottest, o_102 Character, o_103 Animal, o_104 Item, o_105 Costume, o_106 Scene, o_107 Effect, o_108 Others. "tag_list": [ { "tag_id": "o_101" }, { "tag_id": "o_102" } ] Tag and tag_id correspondence: tag_id tag_name o_101 Hottest o_102 Character o_103 Animal o_104 Item o_105 Costume o_106 Scene o_107 Effect o_108 Others 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. Users can provide a customized task ID, which will not overwrite the system-generated task ID but can be used for task queries. Please note that the customized task ID must be unique within a single user account. Invocation examples Create Multi-Image Elements curl --location 'https://xxx/v1/general/advanced-custom-elements/' \ --header 'Authorization: Bearer xxx' \ --header 'Content-Type: application/json\' \ --data '{ "element_name": "xxx", "element_description": "xxx", "reference_type": "image_refer", "element_image_list": { "frontal_image": "xxx", "refer_images": [ {"image_url": "xxx"}, {"image_url": "xxx"} ] }, "element_voice_id": string, "callback_url": "xxx", "external_task_id": "", "tag_list": [ { "tag_id": "xxx" } ] }' Create Video Character Elements curl --location 'https://xxx/v1/general/advanced-custom-elements/' \ --header 'Authorization: Bearer xxx' \ --header 'Content-Type: application/json\' \ --data '{ "element_name": "xxx", "element_description": "xxx", "reference_type": "video_refer", "element_video_list": { "refer_videos": [ { "video_url": "xxx" } ] }, "element_voice_id": string, "callback_url": "xxx", "external_task_id": "", "tag_list": [ { "tag_id": "xxx" } ] }' Query Custom Element (Single) GET /v1/general/advanced-custom-elements/{id} 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, failure reason when failed "task_info": { //Task creation parameters "external_task_id": "string" //Customer-defined task ID }, "task_result": { "elements": [ { "element_id": 0, "element_name": "string", "element_description": "string", "reference_type": "video_refer", "element_image_list": {}, "element_video_list": {}, "element_voice_info": { "voice_id": "string", //Custom voice ID; globally unique "voice_name": "string", //Custom voice name "trial_url": "string", //Trial audio download URL "owned_by": "kling" //Voice source, kling is official, number is creator ID }, "tag_list": [], "owned_by": "kling", //Element source, kling is official element library "status": "succeed" //Element status: succeed when normal, deleted when removed } ] }, "final_unit_deduction": "string", //Final unit deduction for the task "created_at": 1722769557708, //Task creation time, Unix timestamp, ms "updated_at": 1722769557708 //Task update time, Unix timestamp, ms } } 💡 The service related to creating entities has been upgraded to a brand new version. If you need to browse the old version, please proceed to:Kling AI (OLD VERSION) ELEMENTS API Specification 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 of the element creation task. Request path parameter, directly fill the value in the request path. 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 Custom Element (List) GET /v1/general/advanced-custom-elements 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": { "external_task_id": "string" }, //Task creation parameters "task_result": { "elements": [ { "element_id": 0, "element_name": "string", "element_description": "string", "reference_type": "video_refer", "element_image_list": {}, "element_video_list": {}, "element_voice_info": {}, "tag_list": [], "owned_by": "kling", //Element source "status": "succeed" //Element status: succeed, deleted } ] }, "final_unit_deduction": "string", //Final unit deduction "created_at": 1722769557708, //Task creation time, Unix timestamp, ms "updated_at": 1722769557708 //Task update time, Unix timestamp, ms } ] } 💡 The service related to creating entities has been upgraded to a brand new version. If you need to browse the old version, please proceed to:Kling AI (OLD VERSION) ELEMENTS API Specification 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 Data volume per page Value range: [1, 500] Query Presets Element (List) GET /v1/general/advanced-presets-elements 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": { "external_task_id": "string" }, //Task creation parameters "task_result": { "elements": [ { "element_id": 0, "element_name": "string", "element_description": "string", "reference_type": "video_refer", "element_image_list": {}, "element_video_list": {}, "element_voice_info": {}, "tag_list": [], "owned_by": "kling", //Element source "status": "succeed" //Element status: succeed, deleted } ] }, "final_unit_deduction": "string", //Final unit deduction "created_at": 1722769557708, //Task creation time, Unix timestamp, ms "updated_at": 1722769557708 //Task update time, Unix timestamp, ms } ] } 💡 The service related to creating entities has been upgraded to a brand new version. If you need to browse the old version, please proceed to:Kling AI (OLD VERSION) ELEMENTS API Specification 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 Data volume per page Value range: [1, 500] Delete Custom Element POST /v1/general/delete-elements 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 } } 💡 The services related to the delete custom element have been directly upgraded, eliminating the need to browse other documents Request Header Content-Type string Required Default to application/json Data Exchange Format Authorization string Required Authentication information, refer to API authentication Request Body element_id string Required The ID of the element to be deleted; only supports deleting custom elements. Previous chapter：Image Recognize Next chapter：Effect Templates Create Element Invocation examples Query Custom Element (Single) Query Custom Element (List) Query Presets Element (List) Delete Custom Element 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