ComfyUI Node: Zenkai Image Prompt V1

Zenkai Image Prompt V1:

ZenkaiImagePromptV1 is a node designed to facilitate the generation of image prompts by leveraging a collection of images stored in a specified directory. Its primary function is to randomly select an image from a folder, ensuring that the selection process is both deterministic and influenced by a seed value. This node is particularly beneficial for AI artists who wish to incorporate a variety of visual elements into their creative projects, as it allows for the seamless integration of image prompts into their workflows. By supporting common image formats such as JPEG and PNG, ZenkaiImagePromptV1 ensures compatibility with a wide range of image files. Additionally, the node includes a blacklist feature that filters out images containing specific terms, providing users with greater control over the content used in their projects. Overall, ZenkaiImagePromptV1 is a versatile tool that enhances the creative process by offering a structured yet flexible approach to image prompt generation.

Zenkai Image Prompt V1 Input Parameters:

prompt_folder

The prompt_folder parameter specifies the directory path where the image files are stored. This parameter is crucial as it determines the pool of images from which the node will select. The folder should contain images in supported formats such as .jpeg, .jpg, or .png. If the folder does not exist, the node will create it, but it will return a default image and a message indicating that no images were found. This parameter does not have a default value and must be provided by the user.

seed

The seed parameter is used to establish a deterministic order for the random selection of images. By setting a specific seed value, users can ensure that the same sequence of images is selected each time the node is executed, which is useful for reproducibility in creative projects. The seed value can be any integer, and while there is no explicit minimum or maximum, it is typically a positive number. The default value is not specified, so users should provide a seed to achieve consistent results.

blacklist

The blacklist parameter allows users to specify terms that should be excluded from the image selection process. This feature is particularly useful for filtering out unwanted content based on specific keywords. The blacklist is parsed by the node, and any images containing the specified terms in their metadata or filenames are excluded from the selection pool. This parameter is optional, and if not provided, no filtering will occur.

Zenkai Image Prompt V1 Output Parameters:

selected_image

The selected_image output parameter provides the image that has been randomly selected from the specified folder. If no valid images are found, a default tensor representing a blank image is returned. This output is essential for integrating the selected image into subsequent nodes or processes within the AI art workflow.

selected_text

The selected_text output parameter contains a message indicating the status of the image selection process. If a valid image is found, this parameter may include metadata or a description associated with the image. If no valid image is found after applying the blacklist filter, the message will indicate that no valid image-text pair was found. This output helps users understand the outcome of the node's execution and provides context for the selected image.

Zenkai Image Prompt V1 Usage Tips:

• Ensure that the prompt_folder contains a diverse set of images in supported formats to maximize the utility of the node.
• Use the seed parameter to maintain consistency across different runs, especially when testing or iterating on creative projects.
• Leverage the blacklist feature to exclude images that do not align with your project's theme or requirements.

Zenkai Image Prompt V1 Common Errors and Solutions:

No images found in the selected folder

• Explanation: This error occurs when the specified prompt_folder does not contain any images in the supported formats.
• Solution: Verify that the folder path is correct and that it contains images with extensions such as .jpeg, .jpg, or .png.

No valid image-text pair found after blacklist filtering

• Explanation: This message indicates that all images in the folder were excluded based on the terms specified in the blacklist.
• Solution: Review the blacklist terms to ensure they are not overly restrictive, or adjust the contents of the prompt_folder to include images that do not match the blacklist criteria.