n8nen.nl logo n8nen.nl

OpenRouter API instellen in n8n

OpenRouter in n8n werkt het best als je het behandelt als één modelroute met duidelijke grenzen: API key in Credentials, vaste base URL, expliciet model, timeout/fallback en logging zonder secrets. Gebruik deze pagina als praktische setup-check voordat je AI-workflows live laat draaien.

Wanneer kies je OpenRouter in n8n?

Kies OpenRouter wanneer je per workflow tussen meerdere LLM-providers wilt kunnen wisselen zonder elke node opnieuw te bouwen. Gebruik liever een directe provider-credential als compliance, latency of supportcontract zwaarder weegt dan flexibiliteit.

n8n-route: HTTP Request of AI node

Voor simpele chat-completions volstaat de HTTP Request node met OpenRouter headers. Gebruik een AI/LangChain-route wanneer je tool-calling, memory of agentgedrag in n8n wilt beheren. Houd de outputvalidatie daarna buiten de prompt: schema-check, IF node en foutpad.

Productie-check

Leg model, max tokens, timeout, retrybeleid en budget per workflow vast. Stuur nooit volledige credentials of klantdata naar logs; bewaar alleen statuscode, modelnaam, tokenindicatie en foutklasse.

Benodigdheden

• OpenRouter account + API key • Gekozen model/provider • n8n Credentials voor veilige sleutelopslag

Stap 1 – Credentials

Maak een n8n Credential aan voor je OpenRouter API key. Gebruik environment-variabelen en beperk loggingscope om lekken te voorkomen.

Stap 2 – Endpoint & base URL

Gebruik OpenAI-compatibele chat-completions endpoints met base URL van OpenRouter (bijv. https://openrouter.ai/api). Stel model en headers correct in.

Stap 3 – Providers & modellen

Kies een passend model bij de gewenste provider (contextlengte, snelheid, kosten, kwaliteit). Definieer fallbacks bij timeouts of 5xx.

Stap 4 – Streaming & tool-use

Activeer streaming voor snelle tussenresultaten. Overweeg function/tool-calling patronen en valideer input/outputs in je workflow.

Stap 5 – Rate limits & kosten

Implementeer retries met exponential back-off, budgetbewaking, tokenlimieten, caching en batching om kosten en latency te beheersen.

Security

Bewaar sleutels alleen in Credentials, masker secrets in logs en beperk toegang per workflow/gebruiker.

Screenshots

Veelgestelde vragen

Is OpenRouter OpenAI-compatibel?
Ja, OpenRouter biedt OpenAI-compatibele endpoints voor chat completions. Controleer actuele documentatie per provider/model.
Hoe kies ik een model/provider?
Begin met je use-case (contextlengte, latency, budget). Test meerdere modellen en definieer fallbacks voor robuustheid.
Kan ik streaming gebruiken?
Ja, je kunt tokens streamen en UI-componenten/of webhooks tussentijds bijwerken.
Welke base URL gebruik ik voor OpenRouter in n8n?
Gebruik de actuele OpenRouter API base URL uit de officiële documentatie en zet die op één plek in je workflow of credentialconfiguratie. Controleer dit bij elke productie-workflow, want hardcoded oude endpoints zijn lastig terug te vinden.
Hoe voorkom ik dat OpenRouter-kosten uit de hand lopen?
Zet per workflow een tokenlimiet, modelallowlist en fallbackpad. Log alleen samenvattende metadata zoals modelnaam, statuscode en tokenindicatie; geen prompts met persoonsgegevens of API keys.
WA Stel je vraag