ComfyUI > Nodes > ComfyUI-Image-Captioner > Image Captioner

ComfyUI Node: Image Captioner

Class Name

ImageCaptioner

Category
image
Author
neverbiasu (Account age: 1684days)
Extension
ComfyUI-Image-Captioner
Latest Updated
2025-05-12
Github Stars
0.03K

How to Install ComfyUI-Image-Captioner

Install this extension via the ComfyUI Manager by searching for ComfyUI-Image-Captioner
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Image-Captioner 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

Image Captioner Description

Generates precise image captions using AI for enhanced art project tagging.

Image Captioner:

The ImageCaptioner node is designed to enhance your AI art projects by generating precise and relevant captions for images. This node leverages advanced AI models to analyze images and produce descriptive tags that capture key elements such as the main subject, setting, artistic style, and more. By providing succinct and accurate tags, the ImageCaptioner helps improve the understanding of image content, making it easier to recreate or manipulate images with AI tools. This node is particularly beneficial for artists looking to streamline their workflow by automating the image tagging process, ensuring that the generated tags are both comprehensive and relevant to the image's content.

Image Captioner Input Parameters:

image

The image parameter is the primary input for the ImageCaptioner node, where you provide the image that needs to be analyzed and captioned. This parameter expects an image in the form of a tensor, which is a multi-dimensional array used in AI and machine learning to represent data. The image is processed to extract key features and generate descriptive tags. There are no specific minimum or maximum values for this parameter, but it is crucial that the image is correctly formatted as a tensor to ensure accurate caption generation.

api

The api parameter is a string input that requires an API key to authenticate and access the necessary AI models for image captioning. This key is essential for the node to function, as it allows the node to communicate with external services that provide the image analysis capabilities. The API key must be a valid string, and while there is no default value, it is important to ensure that the key is correctly entered to avoid authentication errors.

user_prompt

The user_prompt parameter is a string input that allows you to customize the captioning process by providing specific instructions or preferences for the generated tags. This parameter supports multiline input, enabling you to include detailed guidelines on what aspects of the image should be prioritized in the tags. The default value is a comprehensive prompt that guides the AI to focus on various image elements such as subject, style, and composition. You can modify this prompt to suit your specific needs, ensuring that the generated captions align with your artistic vision.

Image Captioner Output Parameters:

STRING

The output of the ImageCaptioner node is a STRING that contains the generated image captions. This output is a comma-separated list of tags that describe the image's content, capturing essential details and characteristics. The tags are designed to be concise yet informative, providing a clear understanding of the image's elements. This output is crucial for tasks such as image recreation or manipulation, as it offers a structured and detailed description of the image, facilitating better AI-driven results.

Image Captioner Usage Tips:

  • Ensure that the image input is correctly formatted as a tensor to avoid processing errors and ensure accurate caption generation.
  • Customize the user_prompt to focus on specific aspects of the image that are important for your project, enhancing the relevance of the generated tags.
  • Keep your API key secure and ensure it is valid to maintain uninterrupted access to the image captioning services.

Image Captioner Common Errors and Solutions:

Error: Image must be a numpy array.

  • Explanation: This error occurs when the image input is not correctly formatted as a tensor.
  • Solution: Ensure that the image is converted to a tensor format before inputting it into the node.

Error: API key must be a string.

  • Explanation: This error indicates that the API key provided is not a valid string.
  • Solution: Double-check the API key to ensure it is correctly entered as a string.

Error generating captions.

  • Explanation: This error may occur due to issues with the external service or incorrect API key.
  • Solution: Verify the API key and ensure that the external service is operational. If the problem persists, check for any service outages or contact support.

Image Captioner Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-Image-Captioner
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.

Image Captioner