Overview
This node performs image analysis using an AI service provided by Azure OpenAI. It takes one or more image URLs and a text prompt as input, then returns an analysis of the images based on the prompt. This is useful for scenarios such as automatically generating descriptions of images, extracting visual information, or tagging images with relevant content.
Practical examples include:
- Automatically describing product images for e-commerce listings.
- Analyzing photos to generate alt text for accessibility.
- Extracting insights from images in social media monitoring workflows.
Properties
| Name | Meaning |
|---|---|
| Text Input | The prompt or question guiding the image analysis. Default is "What's in this image?". |
| URL(s) | One or multiple URLs of images to analyze, separated by commas. Example: https://example.com/image.jpg |
Output
The node outputs a JSON array where each item contains a single field:
content: A string representing the AI-generated analysis or description of the provided image(s) based on the prompt.
No binary data output is produced by this node.
Example output JSON structure:
[
{
"content": "A detailed description or analysis of the image(s) based on the prompt."
}
]
Dependencies
- Requires an API key credential for the Azure OpenAI image analysis service.
- The node depends on an internal client (
ImageAnalysisClient) that interacts with the Azure OpenAI API. - Proper configuration of the API credentials within n8n is necessary for successful execution.
Troubleshooting
- Missing or invalid API credentials: Ensure the API key credential for the image analysis service is correctly configured and valid.
- Invalid or unreachable image URLs: Verify that the URLs provided are accessible and point directly to image files.
- Empty or malformed prompt: The prompt must be a non-empty string guiding the analysis; otherwise, the results may be irrelevant or empty.
- API rate limits or service errors: If the Azure OpenAI service returns errors, check your subscription limits and network connectivity.
Common error messages might indicate authentication failures, invalid input formats, or network issues. Resolving these typically involves verifying credentials, input correctness, and internet access.