n8n-nodes-rooyai-image

A production-ready Rooyai Image / Vision Model node for n8n, providing first-class AI multimodal visual reasoning, OCR, document analysis, and visual question answering powered by Rooyai's high-speed LLM gateway.

🎯 Overview

The Rooyai Image node brings state-of-the-art vision models to your n8n automation workflows. Easily analyze images from uploaded files, web URLs, or base64 strings with industry-leading multimodal AI models.

✨ Key Features

• 🧠 Top Vision Models: Supports google/gemini-3.1-flash-lite, google/gemini-3-flash-preview, gpt-4o-mini, gemma-4-31B-it, llama-3.3-70b-versatile, moonshotai/kimi-k2.6, and more.
• 🖼️ Flexible Image Inputs:
  • Binary Data: Directly analyze images passed from upstream nodes (HTTP Request, Read File from Disk, Webhook file upload, AWS S3, etc.).
  • Image URL: Analyze images directly from public web links.
  • Base64 String: Pass raw base64 or data:image/... strings.
  • Multiple Images: Analyze and compare multiple images in a single prompt.
• 🔍 Document OCR & Structured JSON Extraction: Extract text, tables, and receipts directly into structured JSON using system instructions and JSON response formatting.
• ⚡ Image Detail Resolution: Choose between auto, low (fast & token-efficient), or high (maximum fidelity).
• 📊 Usage Metrics: Returns token usage statistics (promptTokens, completionTokens, totalTokens) and clean simplified output.

📦 Installation

Option 1: Install in n8n (Community Nodes)

In your n8n instance:

1. Go to Settings > Community Nodes.
2. Click Install a community node.
3. Enter n8n-nodes-rooyai-image.
4. Agree to the risks and click Install.

Option 2: Install via npm in Self-Hosted n8n

# In your n8n installation directory:
npm install n8n-nodes-rooyai-image

# Restart n8n
n8n restart

Option 3: Manual Installation (Development / Custom Directory)

# Create custom nodes directory if needed
mkdir -p ~/.n8n/custom

# Clone or copy into custom directory
git clone https://github.com/rooyai/n8n-nodes-rooyai-image.git ~/.n8n/custom/n8n-nodes-rooyai-image
cd ~/.n8n/custom/n8n-nodes-rooyai-image
npm install
npm run build

# Restart n8n
n8n restart

🔑 Credentials Setup

1. In n8n, navigate to Credentials → Create New Credential.
2. Search for Rooyai API.
3. Enter your API Key from rooyai.com.
4. Click Save and test the connection.

[!NOTE]
If you already have credentials configured for n8n-nodes-rooyai-message, the Rooyai Image node automatically recognizes and shares the same rooyaiApi credential!

🚀 Usage & Examples

Example 1: Analyze an Image from an HTTP Request or File Read

[ Read Binary File / HTTP Request ] ➔ [ Rooyai Image ] ➔ [ Slack / Database ]

• Image Source: Binary Data (Input File from Previous Node)
• Input Data Field Name: data (default)
• Model: google/gemini-3.1-flash-lite (Recommended)
• Prompt: What is in this image? Provide a detailed summary.

Example 2: Invoice / Receipt OCR to Structured JSON

[ Webhook (Receipt Upload) ] ➔ [ Rooyai Image ] ➔ [ Google Sheets / Postgres ]

• Image Source: Binary Data
• System Message: You are an expert OCR engine. Extract merchant name, invoice date, line items, tax, and total amount strictly in JSON format.
• Prompt: Extract all invoice details from this receipt as JSON.
• Options > Response Format: JSON Object

Example 3: Analyze Image from Web URL

[ Trigger ] ➔ [ Rooyai Image ] ➔ [ Output ]

• Image Source: Image URL
• Image URL: https://example.com/product-photo.jpg
• Model: gpt-4o-mini
• Prompt: Identify the product brand, color, condition, and defects.

🤖 Supported Vision Models

⚙️ Configuration Reference

🛠️ Development & Building

# Install dependencies
npm install

# Compile TypeScript and copy icons
npm run build

# Watch mode for development
npm run dev

# Code formatting & linting
npm run format
npm run lint

📄 License

MIT © Rooyai