n8n-nodes-zihin

n8n community nodes for Zihin AI - Unified LLM API with intelligent provider routing, Tool Calling support, and Media Processing (Image Analysis, Audio Transcription, Document Parsing).

Nodes Included

| Node | Type | Description | |------|------|-------------| | Zihin Chat Model | AI Sub-node | LangChain Chat Model for AI Agents with Tool Calling | | Zihin | App Node | Media Processing: Image, Audio, Document |

Installation

Via n8n Community Nodes (Recommended)

1. Go to Settings > Community Nodes > Install
2. Search for n8n-nodes-zihin and install

Via npm

npm install n8n-nodes-zihin

Configuration

1. Get your API Key at zihin.ai > Settings > API Keys
2. In n8n: Credentials > Add Credential > Zihin API
3. Enter your API Key (format: zhn_live_xxx)

Zihin Chat Model

Designed for AI Agents with Tool Calling support.

[Chat Trigger] → [AI Agent] ← [Zihin Chat Model]
                     ↑
                 [Tools]

Usage

1. Add an AI Agent node
2. Connect Zihin Chat Model as the Chat Model
3. Add Tools (Calculator, HTTP Request, etc.)
4. Connect a trigger and execute

Parameters

| Parameter | Default | Description | |-----------|---------|-------------| | Model | auto | LLM model or "Auto" for intelligent routing | | Task Type | chat_general | Task type for auto-routing optimization | | Temperature | 0.7 | Creativity level (0-2) | | Max Tokens | 4096 | Maximum tokens in response |

Advanced Options

| Parameter | Default | Description | |-----------|---------|-------------| | Timeout | 60s | Maximum request timeout | | Max Retries | 2 | Retry attempts with exponential backoff | | Base URL Override | - | Alternative URL for staging/local | | Allow Localhost | false | Allow http://localhost (dev only) | | JSON Output Schema | - | Force structured JSON output |

Supported Models

Models are loaded dynamically from the Zihin API.

Providers: OpenAI, Anthropic, Google, Grok, OpenRouter (DeepSeek, Qwen, Mistral, Llama)

Use Auto for automatic routing based on task type.

Task Types (Auto Mode)

| Task Type | Value | Use Case | |-----------|-------|----------| | General Chat | chat_general | General conversations | | Writing | write | Content creation | | Rewriting | rewrite_edit | Editing and revision | | Extraction | extract_structure | Extract structured data | | Reasoning | reasoning_analysis | Complex analysis | | Code | code | Programming tasks | | Data Query | data_query | SQL, data queries | | Research | research | Investigation |

Zihin (Media Processing)

Process media files with Vision AI, Speech-to-Text, and Document parsing.

Resources & Operations

| Resource | Operation | Description | |----------|-----------|-------------| | Image | Analyze | Vision AI analysis (GPT-4o, Claude) | | Audio | Transcribe | Speech-to-text (Whisper) | | Document | Parse | Extract content (PDF, Excel, CSV, DOCX) |

Image Analysis

| Field | Required | Description | |-------|----------|-------------| | Image | Yes | URL or base64 data URI | | Prompt | No | Analysis instructions | | Extract Text | No | Enable OCR mode | | Detail | No | low, high, auto | | Provider | No | auto, openai, anthropic |

Audio Transcription

| Field | Required | Description | |-------|----------|-------------| | Audio | Yes | URL or base64 data URI | | Language | No | ISO code (pt, en, es...) | | Include Timestamps | No | Add segment timestamps | | Prompt Hint | No | Context for better accuracy |

Supported formats: mp3, wav, ogg, flac, m4a, webm, mp4

Document Parsing

| Field | Required | Description | |-------|----------|-------------| | Document | Yes | URL or base64 data URI | | File Type | No | auto, pdf, xlsx, csv, docx | | Extract Mode | No | text, tables, all | | Sheet Name | No | Excel sheet name | | Max Pages | No | PDF page limit |

URL Tips

For Google Drive files, convert share links to direct download:

# Share link (won't work)
https://drive.google.com/file/d/FILE_ID/view?usp=sharing

# Direct download (works)
https://drive.google.com/uc?export=download&id=FILE_ID

Troubleshooting

| Error | Solution | |-------|----------| | "Invalid API Key" | Verify the key in Zihin dashboard | | "Invalid base URL" | Enable "Allow Custom Base URL" | | "Timeout" | Increase timeout in Options | | "Invalid file format" | Check supported formats |

Security

Protections

• SSRF Prevention: URL validation, private IPs blocked, HTTPS-only
• Payload Limits: Configurable size limits
• Error Sanitization: Sensitive data removed from errors
• Telemetry Privacy: IDs are hashed

Best Practices

• Keep n8n updated (>=1.120.4)
• Use RBAC to restrict workflow editing
• Enable MFA for n8n access
• Rotate API keys periodically

Credential Format

• Production: zhn_live_xxx
• Test: zhn_test_xxx

Changelog

v0.6.0 (2025-02-03)

• New Node: Zihin - Media Processing (Image, Audio, Document)
• Image Analysis: Vision AI with GPT-4o and Claude
• Audio Transcription: Whisper with timestamps
• Document Parsing: PDF, Excel, CSV, DOCX support
• Structured Output: JSON Schema support for Chat Model
• Allow Localhost: Development mode option

v0.5.0 (2025-01-14)

• Security Hardening: SSRF prevention, payload limits
• @langchain/core >=0.3.80: Serialization fix

v0.4.0 (2025-12-24)

• Dynamic Models: Loaded from API
• Task Types: 8 types for auto-routing

v0.3.0 (2025-12-16)

• Timeout, retries, base URL override

v0.2.0 (2024-12-05)

• Chat Model with Tool Calling

v0.1.0

• Initial release

Links

• Zihin Documentation
• Dashboard
• GitHub Issues

License: MIT | Developed by Zihin AI Inc