ComfyUI Node: Z-Image Prompt Enhancer

Z-Image Prompt Enhancer:

The Z_ImagePromptEnhancer is a powerful tool designed to transform simple prompts into detailed visual descriptions, enhancing the creative process for AI artists. This node leverages advanced language models to enrich your initial input, providing a more comprehensive and vivid depiction that can be directly used in image generation tasks. By converting basic prompts into elaborate narratives, it helps in achieving more accurate and visually appealing results. The main goal of this node is to bridge the gap between textual input and visual output, making it an essential component for artists looking to refine their AI-generated imagery.

Z-Image Prompt Enhancer Input Parameters:

config

The config parameter is a required input that specifies the configuration settings for the Z_ImagePromptEnhancer. It determines how the prompt enhancement process is executed, including the selection of language models and other operational parameters. This configuration is crucial as it directly influences the quality and style of the enhanced prompt. The exact structure and options available within config are defined by the ZIMAGE_CONFIG setup.

prompt

The prompt parameter is a required string input where you enter the initial text that you wish to enhance. This can be a simple description or a more complex narrative that you want to transform into a detailed visual prompt. The prompt supports multiline input, allowing for more complex and nuanced descriptions. The default value is an empty string, and it serves as the foundation for the enhancement process.

prompt_template

The prompt_template parameter allows you to select the template style for the prompt enhancement. Options include "auto," "chinese," "english," and "custom," with "chinese" being the default. This selection guides the language model in shaping the enhanced prompt according to the chosen linguistic and stylistic preferences. It is particularly useful for tailoring the output to specific cultural or linguistic contexts.

custom_system_prompt

The custom_system_prompt is an optional multiline string input that lets you provide a custom system prompt when the "custom" option is selected in the prompt_template. This allows for further customization of the enhancement process, enabling you to inject specific instructions or stylistic guidelines into the prompt transformation. The default value is an empty string.

unique_id

The unique_id is a hidden parameter used internally to track and manage sessions. It ensures that each enhancement process is uniquely identified, which is particularly useful in multi-turn conversations or when handling multiple requests simultaneously.

Z-Image Prompt Enhancer Output Parameters:

enhanced_prompt

The enhanced_prompt is a string output that contains the transformed and enriched version of the original prompt. This output is the result of the enhancement process, providing a detailed and visually descriptive narrative that can be used directly in image generation tasks. It captures the essence of the input while adding depth and detail.

debug_log

The debug_log is a string output that provides a detailed log of the enhancement process. It includes timestamps, session information, and any relevant debug messages that were generated during the transformation. This log is useful for troubleshooting and understanding the internal workings of the node, offering insights into how the input was processed and enhanced.

Z-Image Prompt Enhancer Usage Tips:

• Experiment with different prompt_template options to see how they affect the style and detail of the enhanced prompt. This can help you find the best fit for your specific artistic needs.
• Use the custom_system_prompt to inject specific instructions or stylistic preferences into the enhancement process, allowing for greater control over the final output.
• Keep track of the debug_log to understand how your input is being transformed and to troubleshoot any issues that may arise during the enhancement process.

Z-Image Prompt Enhancer Common Errors and Solutions:

Empty input prompt

• Explanation: This error occurs when the prompt parameter is left empty or contains only whitespace.
• Solution: Ensure that you provide a valid and meaningful prompt to be enhanced. The input should not be empty and should contain descriptive text that you wish to transform.

Invalid configuration settings

• Explanation: This error arises when the config parameter is not properly set or contains invalid options.
• Solution: Review the config settings to ensure they are correctly configured according to the ZIMAGE_CONFIG specifications. Double-check for any typos or unsupported options.

Unsupported prompt template

• Explanation: This error occurs when an invalid option is selected for the prompt_template parameter.
• Solution: Choose a valid option from the available prompt_template choices: "auto," "chinese," "english," or "custom." Ensure that the selection matches the intended style and language of the enhancement.