Analyze Images with OpenAI Vision while Preserving Binary Data for Reuse

Description

Use this template to upload an image, run a first-pass OpenAI Vision analysis, then re-attach the original file (binary/base64) to the next step using a Merge node. The pattern ensures your downstream AI Agent (or any node) can access both the original file (data) and the first analysis result (content) at the same time.

✅ What this template does
Collects an image file* via *Form Trigger** (binary field labeled data)
Analyzes the image* with *OpenAI Vision* (GPT-4o) using *base64** input
Merges* the original upload and the analysis result (combine by position) so the next node has *both**
Re-analyzes/uses* the image alongside the first analysis in an *AI Agent** step

🧩 How it works (Node-by-node)
Form Trigger
Presents a simple upload form and emits a binary/base64 field named data.
Analyze image (OpenAI Vision)
Reads the same data field as base64 and runs image analysis with GPT-4o.
The node outputs a text content (first-pass analysis).
Merge (combine by position)
Combines the two branches so the next node receives both the original upload (data) and the analysis (content) on the same item.
AI Agent
Receives data + content together.
Prompt includes the original image (=data) and the first analysis ({{$json.content}}) to compare or refine results.
OpenAI Chat Model
Provides the language model for the Agent (wired as ai_languageModel).

🛠️ Setup Instructions (from the JSON)
> Keep it simple: mirror these settings and you’re good to go.

1) Form Trigger (n8n-nodes-base.formTrigger)
Path:* d6f874ec-6cb3-46c7-8507-bd647c2484f0 *(you can change this)
Form Title:** Image Document Upload
Form Description:** Upload a image document for AI analysis
Form Fields:**
Label: data
Type: file
Output:* emits a binary/base64 field named *data**.

2) Analyze image (@n8n/n8n-nodes-langchain.openAi)
Resource:** image
Operation:** analyze
Model:** gpt-4o
Text:* =data *(use the uploaded file field)
Input Type:** base64
Credentials:* OpenAI (use your stored *OpenAI API** credential)

3) Merge (n8n-nodes-base.merge)
Mode:** combine
Combine By:** combineByPosition
Connect Form Trigger → Merge (input 2)
Connect Analyze image → Merge (input 1)
This ensures the original file (data) and the analysis (content) line up on the same item.

4) AI Agent (@n8n/n8n-nodes-langchain.agent)
Prompt Type:** define
Text:**
System Message:** analyze the image again and see if you get the same result.
Receives:** merged item containing data + content.

5) OpenAI Chat Model (@n8n/n8n-nodes-langchain.lmChatOpenAi)
Model:** gpt-4.1-mini
Wiring:* connect as *ai_languageModel* to the *AI Agent**
Credentials:** same OpenAI credential as above

> Security Note: Store API keys in Credentials (do not hardcode keys in nodes).

🧠 Why “Combine by Position” fixes the binary issue
Some downstream nodes lose access to the original binary once a branch processes it.
By merging the original branch (with data) and the analysis branch (with content) by position, you restore a single item with both fields—so the next step can use the image again while referencing earlier analysis.

🧪 Test Tips
Upload a JPG/PNG and execute the workflow from the Form Trigger preview.
Confirm Merge output contains both data (binary/base64) and content (text).
In the AI Agent, log or return both fields to verify availability.

🔧 Customize
Swap GPT-4o for another Vision-capable model if needed.
Extend the AI Agent to extract structured fields (e.g., objects detected, text, brand cues).
Add a Router after Merge to branch into storage (S3, GDrive) or notifications (Slack, Email).

📝 Requirements
n8n (cloud or self-hosted) with web UI access
OpenAI** credential configured (Vision support)

🩹 Troubleshooting
Binary missing downstream?* Ensure *Merge* receives *both** branches and is set to combineByPosition.
Wrong field name?* The *Form Trigger* upload field must be labeled *data** to match node expressions.
Model errors?* Verify your *OpenAI* credential and that the chosen model supports *image analysis**.

💬 Sticky Note (included in the workflow)
> “Use Binary Field after next step” — This workflow demonstrates how to preserve and reuse an uploaded file (binary/base64) after a downstream step by using a Merge node (combineByPosition). A user uploads an image via Form Trigger → the image is analyzed with OpenAI Vision → results are merged back with the original upload so the next AI Agent step can access both the original file (data) and the first analysis (content) at the same time.

📬 Contact
Need help customizing this (e.g., filtering by campaign, sending reports by email, or formatting your PDF)?

📧 [email protected]
🔗 https://www.linkedin.com/in/robert-breen-29429625/
🌐 https://ynteractive.com