Nodes/Comfyui-Kling-Wrapper/Comfyui-Kling-Wrapper Advanced Element Query
ComfyUI Node

Comfyui-Kling-Wrapper Advanced Element Query

Check on your Kling character registrations

By magicwang1111·Created 5 months ago·Updated 18 days ago· 1
Comfyui-Kling-Wrapper Advanced Element Query
    • element
    • element_id
    • element_json
    query_mode
    identifier

    Advanced Element Create is the node that registers a reusable subject with Kling. This node is its quieter sibling: it asks Kling "what happened to that element, and what's its ID?" You need it because element creation is asynchronous - you submit a task, and the element only exists once Kling finishes processing your reference photos. Query is how you find out whether that happened.

    It's a pure housekeeping node, but a genuinely necessary one in this pack. If you create an element and immediately try to bind it into Image2Video, you'll get a failure because the element isn't ready. This node is the "did it land?" check, and it doubles as a way to recover an element_id you didn't keep track of.

    How to use it

    Two inputs, both simple:

    • query_mode - task_id or element_id. If you're checking on a just-submitted creation, query by the task ID that came back from Create. If you have an element ID and want its current state, query by that instead.
    • identifier - the actual task ID or element ID string to look up.

    That's the whole input surface. Paste an ID, pick a mode, run it.

    Outputs

    The outputs mirror Create's, which is the point - a successful query hands you everything you need to keep building:

    • element - the typed element object for Element List Builder
    • element_id - the registered ID
    • element_json - the raw element payload as a string

    So a clean workflow pattern is: Create → Query → Element List Builder → Image2Video. You can even wire Query's element straight into the list builder if you want to build a pipeline that polls until the element is ready.

    Install and gotchas

    Same pack, same dance: install via ComfyUI Manager (search "Comfyui-Kling-Wrapper") or git clone https://github.com/magicwang1111/Comfyui-Kling-Wrapper.git into custom_nodes, pip install -r requirements.txt, restart, and have your Kling API key in config.local.json. No models, no local compute - just API calls.

    The practical trap is thinking this node creates anything. It doesn't - it only reports state. And there's a sibling gotcha in the same family: if you never created the element, or it failed validation (remember Create's hard limits - name ≤ 20 chars, description ≤ 100, and the frontal-image-plus-1-to-3-references rule), Query will come back empty or with an error, not a helpful "your references were wrong." If that happens, fix the references and re-run Create. The Vapeur provider supports Create and Query, but check that your provider actually registered the element before building a workflow around it.

    For a small node it's oddly load-bearing. Consider it the glue between "I asked Kling to make me a character" and "I'm using that character."

    CategoryComfyui-Kling-Wrapper

    Inputs (2)

    NameTypeDefaultDescription
    query_modeCOMBO2 options: task_id, element_id
    identifierSTRING

    Outputs (3)

    NameTypeDescription
    elementCOMFYUI_KLING_WRAPPER_ELEMENT
    element_idSTRING
    element_jsonSTRING