Comfyui-Kling-Wrapper
This is a custom node pack for ComfyUI that lets you call the Kling AI API directly inside ComfyUI.
The node pack has been upgraded for the new Kling API system and current 3.0-era models, including:
- Image generation:
kling-image-o1,kling-v3,kling-v3-omni - Video generation:
kling-v2-5-turbo,kling-v2-6,kling-video-o1,kling-v3,kling-v3-omni - New-system features: intelligent shot mode, reference video, element binding, motion control, and advanced custom elements
Official references:
- Kling AI NEW API Specification
- Kling AI Series 3.0 Model API Specification
- Kling Omni Model API Specification
- Kling V2.6 Model API Specification
Requirements
Before using this node, you need to have a KLing AI API key.
Installation
Installing manually
-
Navigate to the
ComfyUI/custom_nodesdirectory. -
Clone this repository:
git clone https://github.com/KwaiVGI/ComfyUI-KLingAI-API -
Install the dependencies:
- Windows (ComfyUI portable):
python -m pip install -r ComfyUI\custom_nodes\ComfyUI-KLingAI-API\requirements.txt - Linux or MacOS:
cd ComfyUI-KLingAI-API && pip install -r requirements.txt
-
If you don't want to expose your key, you can add it into the
config.inifile and keep it empty in the node. -
Start ComfyUI and search for nodes prefixed with
Comfyui-Kling-Wrapper.
Naming
All exported node names now use the Comfyui-Kling-Wrapper prefix and the category Comfyui-Kling-Wrapper.
Nodes
Workflow JSON examples now live in examples/README.md. The old screenshot-based examples have been replaced with importable ComfyUI workflows and updated Python API snippets.
Client
This node is used to create a KLing AI client.
Image Generator
This node is used to generate an image given a text prompt.
Text2Video
This node is used to generate a video given a text prompt.
Image2Video
This node is used to generate a video given an image.
Multi Images To Video
This node is used to create a video from a batch of reference images.
Kolors Virtual Try-On
This node is used to display the try-on effect.
Video Extend
This node is used to extend a video.
Lip Sync
This node is used to generate a lip sync video.
Effects
You can achieve different special effects based on the effect_scene.
ImageExpander
This node is used to expand a image.
Video2AudioNode
This node is used to generate a audio from video.
TextToAudioNode
This node is used to generate a audio from text.
Advanced Element Create
Creates an advanced custom element with the new asynchronous advanced-custom-elements API.
Advanced Element Query
Fetches an advanced custom element by task ID or element ID.
Element List Builder
Builds an element_list payload that can be fed into the latest video-generation nodes.
Motion Control
Creates motion-control videos with the new-system motion control API.
Voice Presets
Comfyui-Kling-Wrapper Text2Video and Comfyui-Kling-Wrapper Image2Video now expose a voice_preset dropdown instead of requiring manual voice_list JSON input. The node sends the selected preset as:
[{"voice_id":"..."}]
These built-in presets are intended for models that support voice_list on the active endpoint, and are especially useful with kling-v2-6:
Sunny:genshin_vindi2Sage:zhinen_xuesheng运动少年:tiyuxi_xuediBlossom:ai_shatangPeppy:genshin_klee2元气少女:guanxiaofang-v2Shine:ai_kaiya幽默小哥:tiexin_nanyouLyric:ai_chenjiahao_712甜美邻家:girlfriend_1_speech02Tender:chat1_female_new-3职场女青:girlfriend_2_speech02Zippy:cartoon-boy-07Sprite:cartoon-girl-01Rock:ai_huangyaoshi_712Helen:you_pingjingTitan:ai_laoguowang_712Grace:chengshu_jiejie慈祥爷爷:zhuxi_speech02唠叨爷爷:uk_oldman3Prattle:laopopo_speech02Hearth:heainainai_speech02东北老铁:dongbeilaotie_speech02重庆小伙:chongqingxiaohuo_speech02四川妹子:chuanmeizi_speech02潮汕大叔:chaoshandashu_speech02台湾男生:ai_taiwan_man2_speech02西安掌柜:xianzhanggui_speech02天津姐姐:tianjinjiejie_speech02新闻播报男:diyinnansang_DB_CN_M_04-v2译制片男:yizhipiannan-v1撒娇女友:tianmeixuemei-v1刀片烟嗓:daopianyansang-v1乖巧正太:mengwa-v1Ace:AOTDove:genshin_kiraraAnchor:oversea_male1Melody:girlfriend_4_speech02Siren:chat_0407_5-1Bud:uk_boy1Candy:PeppaPig_platformBeacon:ai_huangzhong_712Lore:calm_story1Crag:uk_man2The Reader:reader_en_m-v1Commercial Lady:commercial_lady_en_f-v1
Pricing
For pricing, follow KLing AI Pricing. The nodes also log final_unit_deduction from API responses when the API returns it.