Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-Omnichar > Character References Split

ComfyUI Node: Character References Split

Class Name

OmnicharCharacterReferencesSplit

Category
Omnichar
Author
omnichar (Account age: 118days)
Extension
ComfyUI-Omnichar
Latest Updated
2026-10-11
Github Stars
0.08K

How to Install ComfyUI-Omnichar

Install this extension via the ComfyUI Manager by searching for ComfyUI-Omnichar
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Omnichar in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Character References Split Description

Efficiently distributes character references across multiple output slots for precise control in AI art generation workflows.

Character References Split:

The OmnicharCharacterReferencesSplit node is designed to efficiently manage and distribute character references across multiple output slots, aligning with a model's reference slots. This node is particularly useful in scenarios where each character reference needs to be processed or utilized independently. By splitting the references, it ensures that each one is outputted separately, allowing for precise control and manipulation in AI art generation workflows. The node automatically handles the distribution of references, ensuring that any slots beyond the available references remain empty, thus preventing any misalignment or confusion in the reference numbering. This functionality is crucial for maintaining consistency and accuracy in models that rely on specific reference inputs.

Character References Split Input Parameters:

refs

The refs parameter is a required input that consists of the character references to be split across the output slots. This parameter is crucial as it determines the number of references that will be processed and distributed by the node. The input should be a collection of references, and the node will handle up to a fixed number of slots, which is defined by the system. Any references beyond this number will not be processed, and the corresponding slots will remain empty. This ensures that the node operates within its designed capacity and maintains the integrity of the reference distribution.

Character References Split Output Parameters:

image_0, image_1, image_2, image_3, image_4

These output parameters represent the individual slots where each character reference is placed. Each image_n corresponds to a specific reference, with n indicating the slot number. The node outputs the references as images, allowing for further processing or integration into other workflows. If there are fewer references than slots, the remaining outputs will be None, ensuring that no placeholder images are mistakenly used as valid references.

count

The count output parameter provides the total number of references that were successfully processed and split by the node. This count is useful for understanding how many references were utilized and can help in debugging or optimizing workflows by ensuring that the expected number of references is being handled.

Character References Split Usage Tips:

  • Ensure that the number of references provided does not exceed the fixed number of slots to avoid unused references.
  • Leave any unused slots unwired to prevent confusion or errors in downstream processes.

Character References Split Common Errors and Solutions:

CharChanged

  • Explanation: This error occurs when there is a change in the character reference that the node cannot handle.
  • Solution: Verify the integrity and consistency of the character references being inputted. Ensure that no modifications have been made to the references that could trigger this error.

IndexError

  • Explanation: This error might occur if the number of references exceeds the available slots.
  • Solution: Check the number of references being inputted and ensure it does not exceed the node's capacity. Adjust the input to fit within the fixed number of slots.

Character References Split Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-Omnichar
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Character References Split