ComfyUI Node
Character Reference Prepare
Choose how one face/body/clothing/rear reference is prepared. This node supplies prompts and source data; connected encoder/sampler nodes generate the image. File defaults come from prompts/character_references.json. Connected STRING overrides replace those defaults. Connect reference to Character Reference Select to apply the chosen mode.
Character Reference Prepare
- image
- reference
- positive
- negative
- source
◄roleface►
◄modereference►
◄description►
◄instructions►
◄positive_override—►
◄negative_override—►
Category🌒 Eclipse/ Image
Inputs (7)
| Name | Type | Default | Description |
|---|---|---|---|
| role | COMBO | face | Select the file prompt category: face for identity/hair, body for proportions, clothing for wardrobe, rear for compatible back details. Connect Select's image to the matching Pack input. Changing role does not rewrite a connected positive/negative override. |
| mode | COMBO | reference | reference passes the source through; extract uses the source to generate an isolated reference; generate creates one from text without using the source; disabled omits it. Select skips its sampler branch in reference/disabled modes. When using overrides, update their text yourself after changing mode. Clothing defaults can also complete missing outfit pieces. |
| description | STRING | Details for this preparation task, such as facial features, body proportions or outfit items. Appends to the file positive; does not replace it or affect the negative. Ignored and hidden when positive_override is connected. Reference/disabled modes do not generate from this text. | |
| instructions | STRING | Additional preparation instructions appended after description, such as what to preserve or exclude. Ignored and hidden when positive_override is connected. Does not change the negative or the Pack's assembly rules. | |
| imageopt | IMAGE | One source image, required for reference/extract. Generate/disabled skip it. Uses the full input image; crop/resize and preview upstream if needed. Image batches are not supported. | |
| positive_overrideopt | STRING | Connect String Multiline to replace the entire preparation positive, including file text, description and instructions. Passed exactly as supplied; connected empty text clears it. Edit this text in the workflow: file edits will not update it. Disconnect to restore role/mode defaults. Keep it appropriate to the selected task. | |
| negative_overrideopt | STRING | Connect String Multiline to replace this role's preparation negative independently of the positive. Connected empty text means no negative prompt. Disconnect to use the file default. This does not replace the Pack's assembly/dataset negative. |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| reference | ECLIPSE_CHARACTER_REFERENCE | Role, mode and source data for Character Reference Select. This is a control object, not an image or prompt. |
| positive | STRING | Preparation prompt for the connected image encoder in extract/generate modes. Comes from the file plus details, or exactly from positive_override. Reference/disabled modes bypass preparation generation through Select. |
| negative | STRING | Preparation negative for the same encoder/sampler branch. Uses this role's file negative unless negative_override is connected. |
| source | IMAGE | Full source image for the extraction encoder; present in reference/extract modes. No image in generate/disabled modes. Use Select's image output for the final Pack input. |