n8n OpenRouter Pro Node (Unofficial Community)

English | Русский

⚠️ This is an unofficial community node for n8n, built and maintained by community contributors.

🚀 Sign up for OpenRouter: https://openrouter.ai/

This package adds two nodes to n8n:

• OpenRouter Chat Model — selects model + generation preferences.
• OpenRouter Pro Chain — sends prompts, attachments, structured output schema, and caching controls.

Features

• OpenRouter credential support with API key auth.
• Model selection from /models or manual model ID.
• Generation tuning (temperature, top_p, max tokens, frequency penalty).
• Provider filters (Provider Only / Provider Ignore, mutually exclusive).
• Multimodal attachments: image, audio, video, PDF.
• Structured output with JSON Schema.
• Prompt caching controls (vendor + Anthropic TTL increase).
• Output mode control for n8n items.

Installation (n8n Community Nodes)

1. Open n8n.
2. Go to Settings → Community Nodes.
3. Click Install.
4. Enter package name: n8n-nodes-pikoolev-openrouter-pro.
5. Confirm and restart n8n if prompted.

Credential: OpenRouter API

Fields:

• API Key (required)
• Base URL (default: https://openrouter.ai/api/v1)
• HTTP-Referer (optional)
• Title (optional, sent as X-Title)

Authentication docs:

• https://openrouter.ai/docs/api-reference/authentication

Node 1: OpenRouter Chat Model

Main field

• Model Name or ID

Model Preferences

• Temperature
• Max Output Tokens
• Top P
• Frequency Penalty

Settings

• Provider Ignore
  • Enabled
  • Providers (comma-separated)
• Provider Only
  • Enabled
  • Providers (comma-separated)

Provider Ignore and Provider Only cannot be enabled together.

Node 2: OpenRouter Pro Chain

Base fields

• Model
• User Prompt
• System Message (optional)
• Additional Messages
  • Role (User / Assistant / System)
  • Content

Prompt Attachments

Image

• Source (Public URL / Base64 String)
• Image URL
• Base64 Image
• Image MIME Type

Audio

• Source (Public URL / Base64 String)
• Audio URL
• Base64 Audio
• Audio Format
• Audio MIME Type

Video

• Source (Public URL / Base64 String)
• Video URL
• Base64 Video
• Video MIME Type

PDF

• Source (Public URL or Data URI / Base64 String)
• PDF URL or Data URI
• Base64 PDF
• Filename
• PDF MIME Type

OpenRouter guides:

• Models overview: https://openrouter.ai/docs/guides/overview/models
• Multimodal images: https://openrouter.ai/docs/guides/overview/multimodal/images
• Multimodal PDFs: https://openrouter.ai/docs/guides/overview/multimodal/pdfs
• Multimodal audio: https://openrouter.ai/docs/guides/overview/multimodal/audio
• Multimodal videos: https://openrouter.ai/docs/guides/overview/multimodal/videos

Structured Output

• Enable Structured Output
• Schema Name
• Schema Description (optional)
• JSON Schema

Docs:

• https://openrouter.ai/docs/guides/features/structured-outputs

Caching

• Enable Caching
• Cache Vendor (Auto / Anthropic)
• Increase Cache TTL (Anthropic only)

Prompt caching best practices:

• https://openrouter.ai/docs/guides/best-practices/prompt-caching

Output Mode

• Full Response
• First Completion Text

Local development

npm install
npm run build
npm run dev

---

Copyright © Александр Пикулев