It bundles image generation, text-to-video, image-to-video, multi-image video, advanced custom elements, motion control, lip sync, text/video to audio, effects, virtual try-on, image expansion, and local preview helpers under the Comfyui-Kling-Wrapper category.

Highlights

Direct Kling API access from ComfyUI workflows
New-system features such as element_list, advanced custom elements, reference video, and motion control
Built-in voice_preset dropdown for models that support native audio generation
Importable example workflows in examples/README.md

Current model visibility

The plugin keeps the visible model dropdowns aligned with models verified on the active endpoint.

Visible image generation models:

kling-v1
kling-v1-5
kling-v2
kling-v2-new
kling-v2-1
kling-v3

Visible text-to-video models:

kling-v1
kling-v1-6
kling-v2-master
kling-v2-1-master
kling-v2-5-turbo
kling-v2-6
kling-v3

Visible image-to-video models:

kling-v1
kling-v1-5
kling-v1-6
kling-v2-master
kling-v2-1
kling-v2-1-master
kling-v2-5-turbo
kling-v2-6
kling-v3

Visible multi-image video models:

kling-v2-1
kling-v2-5-turbo
kling-v3

Documented newer models such as kling-image-o1, kling-video-o1, and kling-v3-omni still exist in the internal capability map, but are hidden from the UI until live endpoint support is confirmed for normal accounts.

Important limitations

Native sound and voice_preset support is currently only verified for kling-v2-6 on the active endpoint.
kling-v3, kling-v3-omni, and kling-video-o1 may appear in official docs, but the current public endpoint does not expose native sound control for them through this plugin.
Advanced Element Create requires 1 frontal subject image plus 1-3 additional reference images of the same subject. Background images do not count as reference images.
Advanced Element Create also enforces element_name <= 20 characters and element_description <= 100 characters.
If you need both strong subject consistency and voiced output, the reliable flow on the current endpoint is usually: generate the bound subject video first, then add speech with Lip Sync, TextToAudio, or Video2Audio.

Requirements

Before using these nodes, you need a Kling API key:

Kling API key documentation

Python dependencies are listed in requirements.txt.

Installation

Manual installation

Open your ComfyUI/custom_nodes directory.

Clone this repository:

git clone https://github.com/magicwang1111/Comfyui-Kling-Wrapper.git

Install dependencies:

Windows (portable ComfyUI):

python -m pip install -r ComfyUI\custom_nodes\Comfyui-Kling-Wrapper\requirements.txt

Linux or macOS:

cd Comfyui-Kling-Wrapper
pip install -r requirements.txt

Create config.local.json in the repository root.

You can copy config.example.json and fill in your Kling credentials:
```
{
  "access_key": "",
  "secret_key": "",
  "poll_interval": 1.0,
  "request_timeout": 30,
  "area": "global",
  "oss_endpoint": "",
  "oss_access_key_id": "",
  "oss_access_key_secret": "",
  "oss_bucket": "",
  "oss_prefix": "kling_uploads",
  "oss_signed_url_expires": 86400
}
```
Notes:
- config.local.json is ignored by git and should hold your real private keys.
- config.example.json is only a template and is never read as live config.
- Legacy config.ini is still accepted as a fallback for KLINGAI_API_ACCESS_KEY and KLINGAI_API_SECRET_KEY.
Restart ComfyUI and search for nodes prefixed with Comfyui-Kling-Wrapper.

Node list

Comfyui-Kling-Wrapper Image Generator
Comfyui-Kling-Wrapper Image Expander
Comfyui-Kling-Wrapper Text2Video
Comfyui-Kling-Wrapper Image2Video
Comfyui-Kling-Wrapper Multi Images To Video
Comfyui-Kling-Wrapper Virtual Try On
Comfyui-Kling-Wrapper Video Extender
Comfyui-Kling-Wrapper Lip Sync
Comfyui-Kling-Wrapper Lip Sync Text Input
Comfyui-Kling-Wrapper Lip Sync Audio Input
Comfyui-Kling-Wrapper Effects
Comfyui-Kling-Wrapper TextToAudio
Comfyui-Kling-Wrapper Video2Audio
Comfyui-Kling-Wrapper Advanced Element Create
Comfyui-Kling-Wrapper Advanced Element Query
Comfyui-Kling-Wrapper Element List Builder
Comfyui-Kling-Wrapper Motion Control
Comfyui-Kling-Wrapper Preview Video
Comfyui-Kling-Wrapper Preview Audio

Motion control notes

Motion Control now accepts reference video only from workflow inputs:

reference_video_input: connect a node that outputs VIDEO
reference_video_frames + reference_video_info: connect an uploaded video loader that outputs decoded frames plus timing metadata
reference_video: pass an existing public http(s) video URL directly

Reference images and local reference videos must be reachable by Kling before generation starts. If OSS settings are present in config.local.json or environment variables (OSS_ENDPOINT, OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET, OSS_BUCKET, OSS_PREFIX), the wrapper uploads media to Aliyun OSS first and sends Kling a signed temporary download URL. Without OSS, it falls back to public temporary hosts: tmpfiles.org, then catbox.moe.

The visible model_name dropdown for motion control is:

kling-v2-6
kling-v3

duration is now a dropdown with:

auto
3
5
10
15
30

When duration is set to auto, the node tries to match the uploaded reference video's duration using the connected video metadata or the VIDEO input object.

character_orientation controls whether subject orientation follows the reference image or the reference video:

image: keep orientation from the reference image while transferring motion from the video
video: follow both motion and orientation from the reference video

Voice presets

Text2Video and Image2Video expose a voice_preset dropdown instead of requiring manual voice_list JSON.

The selected preset is converted to:

[{"voice_id":"..."}]

These presets are mainly intended for models that support native audio generation on the active endpoint, especially kling-v2-6.

Examples

Example workflows and small Python snippets live in examples/README.md.

The workflow JSON files no longer depend on a front-end Client node. Prepare config.local.json first, then import the workflow you want to run.

Official references

Notes

The nodes log final_unit_deduction when the API returns billing information. This is useful when checking the real unit cost of newer Kling endpoints and workflows.