zihin

n8n nodes for Zihin AI - Chat Model with Tool Calling, Image Analysis, Audio Transcription, Document Parsing

Package Information

Downloads: 136 weekly / 314 monthly
Latest Version: 0.6.2
Author: Zihin AI Inc.

Available Nodes

Zihin Chat Model icon
Zihin Chat Model
Chat Model for Zihin LLM Gateway with intelligent provider routing and Tool Calling support
Zihin icon
Zihin
Process media with Zihin AI - Image Analysis, Audio Transcription, Document Parsing

Documentation

n8n-nodes-zihin

npm version
License: MIT

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

License: MIT | Developed by Zihin AI Inc

Discussion