Image Analysis
Overview
The Image Analysis Node uses advanced AI models to interpret and analyze images. It can describe objects, scenes, and actions in an image or provide targeted answers to specific questions about it.
This node is ideal for workflows that involve image understanding, such as detecting objects, summarizing visual content, generating image captions, or answering user-defined questions about uploaded or generated images.
It is fully designed for no-code workflows, enabling users to perform complex visual AI analysis without writing any code.
Description
Extract insights from images using AI.
Use the Image Analysis Node to automatically analyze images and generate detailed descriptions or answers. It supports two main modes of operation:
General Description
Automatically generate a detailed caption or summary of the image content.
Visual QA
Ask specific questions about the image to get targeted answers.
You can upload or reference one or more images through the attachments field. The AI will automatically analyze them and generate a response based on your input.
Input Parameters
The Image Analysis node accepts flat key-value inputs that define which images to analyze and what kind of information the AI should extract.
analysisTypestringRequired"image-analysis"attachmentsstringRequired"file1.png,file2.jpg" or "{{imageGen.output.image}}"questionstringOptional"What is the person holding?"Provide all inputs as flat key-value pairs.
Dynamic variables can be referenced using {{nodeId.output.<key>}} syntax to link outputs from previous nodes.
Output Parameters
After execution, the Image Analysis node provides the AI’s interpretation of the image along with processing details.
contentstringOptional"This is a warm, well-lit indoor scene..."dataarrayOptional[{"age_range": ..., "emotions": ...}]processingTimestringOptional"6.272"processingIdstringOptional"xai-grok-1761734286842"Access the generated description in your workflow using:
{{nodeId.output.content}}
Output Type
Output Type: text
This node always outputs textual AI analysis results about one or more images. Do not modify this type — it ensures the output is recognized properly in downstream workflow nodes.
Example Usage
Example 1: General Image Description
Generate a detailed description of an uploaded image.
{ "analysisType": "image-analysis", "attachments": "file123.jpg", "question": "Describe the image."}
{ "content": "### Detailed Description of the Image\n\nThis is a warm, well-lit indoor scene capturing a young Black woman studying at a wooden desk...", "processingTime": "6.272", "processingId": "xai-grok-1761734286842", "processingCount": 533}
Example 2: Visual Question Answering
Ask a specific question about the image.
{ "analysisType": "image-analysis", "attachments": "{{imageGenNode.output.image}}", "question": "Is the person wearing glasses?"}
{ "content": "No, the person in the image is not wearing glasses.", "processingTime": "2.145", "processingId": "xai-grok-9988776655", "processingCount": 12}
How to Use in a No-Code Workflow
Add the Node
Drag and drop the Image Analysis Node into your workflow.
Provide Attachments
Connect the output of an image-generating or image-uploading node to the attachments field.
Set Analysis Type
Always use "image-analysis" for the analysisType field.
Add an Optional Question
Enter a specific question (e.g., “Is this food vegetarian?”) or leave it blank for a general analysis.
Run the Workflow
The node will analyze the provided image(s) and generate a text-based interpretation.
Use Output
Access the result using {{nodeId.output.content}} in downstream nodes like Text Generation, Reporting, or Notifications.
Best Practices
- Always ensure attachments contain valid image files or variable references.
- Keep the question short and specific for better results.
- If analyzing multiple images, use comma-separated references for consistent results.
- Combine this node with Text Generation or Report Creation nodes to turn image insights into summaries or structured reports.
- Use high-quality images for more accurate AI interpretation.
Do / Don’t
- ✔️ Use high-resolution images where objects are clearly visible.
- ✔️ Be specific with your questions (e.g., "What color is the car?" instead of "Tell me about the car").
- ✔️ Use this node for accessibility features like generating alt text.
- ❌ Don’t use blurry or extremely dark images.
- ❌ Don’t ask questions about details that are too small to see.
- ❌ Don’t expect the AI to identify specific individuals (facial recognition for identity is often restricted).
Common Errors
Missing attachmentsErrorOptionalInvalid analysisTypeErrorOptionalNo content outputErrorOptionalFile not accessibleErrorOptionalExample Workflow Integration
Use Case 1: Automated Alt Text Generation
Automatically generate accessibility descriptions for uploaded images.
- File Upload Node – User uploads an image.
- Image Analysis Node – Generates a description of the image.
- Database Node – Stores the image URL and the generated description.
Workflow Data Flow:
{{fileUpload.output.fileId}} → {{imageAnalysis.input.attachments}}
{{imageAnalysis.output.content}} → {{database.input.altText}}
Use Case 2: Visual Content Moderation
Check if an uploaded image contains inappropriate content.
- File Upload Node – User uploads an image.
- Image Analysis Node – Asks "Does this image contain inappropriate content?".
- Logic Node (If/Else) – Checks if the answer is "Yes" or "No".
- Email Node – Alerts the admin if content is flagged.
Workflow Data Flow:
{{fileUpload.output.fileId}} → {{imageAnalysis.input.attachments}}
"Does this image contain unsafe content?" → {{imageAnalysis.input.question}}