Tutorials

Guides, walkthroughs, and integration how-tos.

Build a Reliable Tool-Calling Agent Loop on OpenRouter

A tool-calling agent loop sends the conversation and tool definitions to a model, runs the tool calls the model returns, appends the results, and repeats until the model answers or a stop condition fires. This guide builds that loop in TypeScript with the OpenRouter SDK, then adds an iteration cap, repeated-call detection, model fallback, and history controls.

September 17, 2026

LLM-as-a-Judge: Score AI Agent Outputs Automatically

An LLM judge is a second model that scores an agent's output against criteria you write in plain language. This guide explains where a judge fits beside deterministic tests and human review, then shows how to add one to an Ori Eval test, compare candidate models, calibrate the threshold against human-labeled examples, and keep evaluation cost under control.

September 14, 2026

OpenRouter Text-to-Speech: API Tutorial in 5 Minutes

Our OpenAI-compatible speech endpoint puts TTS models from Mistral, xAI, Microsoft, and more behind one request shape. Here's the path from API key to a playable MP3 in cURL, Python, JavaScript, and the OpenAI SDK, plus the response checks that keep JSON errors out of your audio files.

September 11, 2026

How to Use OpenRouter Presets: Config-as-Code Guide

A preset is config-as-code for your LLM calls: a named, versioned set of models, system prompts, provider routing, and sampling parameters. Define it once, reference it as @preset/your-slug everywhere, and update every app from the dashboard without a redeploy.

September 10, 2026

Nano Banana API: Edit Images with Gemini in Code

Send a source image and an edit prompt in one request, get the edited image back, and change the editing model by editing a single field. Runnable Python and TypeScript included.

September 9, 2026

How to Choose the Best AI Model (Live, in Your Editor)

There's no single best AI model, only the best model for a given task, budget, and moment. This article describes a six-step framework for choosing one, and how to run every step from your editor through the OpenRouter MCP server.

August 25, 2026

OpenRouter Video Generation API: A Code-First Guide

Every video provider has its own endpoint, job statuses, polling logic, and output format. Our async video API puts Seedance, Veo, Wan, and more behind one submit, poll, and download loop. Here's the full lifecycle in Python and TypeScript.

August 25, 2026

OpenRouter Image Generation: A Code-First API Tutorial

Supporting more than one image provider means handling different endpoints, data formats, and billing models. Our dedicated Image API gives you one request format and one key across supported models. Here's the full prompt-to-local-file workflow in Python and JavaScript.

August 17, 2026

How to Send an Image to an LLM via API (Vision Guide)

To get a model to read a screenshot, you need the right request body. This guide shows the content-array pattern that works across every vision-capable model we support, when to use base64 instead of a hosted URL, and how to build multimodal RAG on top of it.

August 14, 2026

Tool Calling Across Any Model: Write the Loop Once, Swap the Model String

Most tool-calling tutorials cover one provider, so you rewrite the loop when you switch. This guide shows the full loop in Python, JavaScript, and cURL, then runs it against three providers by changing one string.

August 12, 2026

Set Up Team AI Spend Controls on OpenRouter

OpenRouter has five controls for team spend: an organization with a shared credit pool, presets that scope models per workload, per-key spend caps, guardrails that enforce per-member budgets, and the Activity dashboard that shows who spent what. This guide sets them all up in one pass, in order.

August 7, 2026

Using OpenRouter With LangChain: ChatOpenRouter Setup Guide

The LangChain integration now has a dedicated package: langchain-openrouter on PyPI and @langchain/openrouter on npm. Most guides still teach the old ChatOpenAI base_url override. This is the current path, plus the routing economics the docs skip.

July 29, 2026

Image Generation Models on OpenRouter

Generation runs through the dedicated /api/v1/images endpoint and understanding through /chat/completions, with the same key and billing. Here's the full contract for both jobs, plus the fix for the 'no endpoints found' error.

July 27, 2026

Transcription on OpenRouter

Send base64 audio to POST /api/v1/audio/transcriptions and get JSON text plus a usage object back, with the same API key you already use for chat. Here's the full request contract, the model families, and the limits to design around.

July 22, 2026

The Cheapest Token Is a Cached One: Prompt Caching + Sticky Routing

Your agent sends the same system prompt, tool definitions, and schemas on every turn. Cache reads cost 0.1x to 0.5x of fresh input, but only if the next request lands on the provider holding the warm cache. Here's how caching and sticky routing work together, and how to confirm they're working.

July 21, 2026

Connect OpenClaw to OpenRouter

OpenClaw has built-in OpenRouter support. One command gives your agents one key, one bill, and automatic failover across 300+ models. Here's the setup and the fixes for the errors that trip people up.

June 18, 2026

How to Connect SillyTavern to OpenRouter (2026 Guide)

One OpenRouter key gives SillyTavern 300+ models in a single dropdown, many of them free to start. Here's the five-step connection, the roleplay models to try, and fixes for the errors users hit most.

June 18, 2026

Kilo Code + OpenRouter: Setup, Model Routing, and Free Models

Kilo Code is a bring-your-own-provider coding agent, so adding OpenRouter gives it one key for 300+ models, provider routing, and failover. Here's the three-step setup plus the kilo.json fields that control routing.

June 17, 2026

How to Use OpenAI Codex CLI with OpenRouter

Codex CLI supports custom OpenAI-compatible providers, so a small config.toml block routes it through OpenRouter. You get provider failover, usage tracking, and one key across every model, with no change to Codex itself.

June 17, 2026

How to Use Claude Code with OpenRouter

Route Claude Code through OpenRouter with three environment variables and no local proxy. You get provider failover, budget controls, and usage visibility on top of the same Anthropic models.

June 16, 2026

How to Use OpenRouter With Any Coding Agent or AI Tool

Any tool that speaks the OpenAI API works with OpenRouter after two changes, the base URL and the key. Here's the setup pattern and the tools that already support it.

June 16, 2026

Free LLM APIs Compared: Rate Limits, Models, and Real Costs (2026)

Stop guessing which free LLM API survives past a side project. Here's how OpenRouter, Groq, Gemini, and 10 more compare on limits, cost, and data use.

June 15, 2026

Keep Your Agent Running When Models Disappear

Anthropic restricted Claude Fable 5 just days after launch. If your code hard-codes a model slug, that becomes your outage too. Presets move model choice to the server so you can swap models, set fallbacks, and enforce a data policy without redeploying.

June 15, 2026

How to Use Hermes Agent with OpenRouter: Setup, Models & Routing

Hermes Agent has pushed over 17 trillion tokens through OpenRouter. Here's how to set it up, pick a model that clears the 64K context bar, and tune routing for cost and reliability.

June 12, 2026

How to Get the Lowest-Cost LLM Inference on OpenRouter

Append :floor for the cheapest provider, cap spend with max_price, and start free with 20+ zero-cost models. Plus the billing gotchas to avoid.

June 12, 2026

Gemini 2.5 Flash API - Pricing, Quickstart & Provider Comparison

Overpaying for reasoning you don't need? Learn how to configure Gemini 2.5 Flash API thinking budgets, compare providers, and make your first call in 5 minutes.

June 9, 2026

EU AI Act & Colorado ADMT Compliance: Human Oversight for AI Agents

Use the Agent SDK's human-in-the-loop (HITL) tools to meet AI agent compliance requirements from the EU AI Act, Colorado's Automated Decision-Making Technology law (SB26-189), and NIST AI RMF.

June 8, 2026

Human-in-the-Loop Tools for the Agent SDK

A new tool type in the OpenRouter Agent SDK lets your agent auto-resolve routine decisions and pause for human input on high-stakes ones, with two hooks and zero loop-management code.

May 8, 2026

Agent SDK: Building Multi-turn Agent Workflows on OpenRouter

The OpenRouter Agent SDK gives you callModel: one function that turns a chat completion into a multi-step agent with tool calls, stop conditions, and cost tracking across 400+ models.

April 24, 2026

Build Your Own Harness with the Agent SDK

Use the create-agent-tui and create-headless-agent skills to scaffold a personalized coding agent in minutes — with a terminal UI or headless for scripts and pipelines.

April 24, 2026

Distillable Models and Synthetic Data Pipelines with NeMo Data Designer

How to generate license-safe synthetic data workflows for model specialization

December 24, 2025

Presets: How To Seamlessly Transfer Model Configurations Across Apps

Customize once and use everywhere. Server-side presets now simplify your model workflows.

July 29, 2025

Use OpenRouter Models in Cursor: Try it with Moonshot AI's Kimi K2

Explore it in action: See how effortlessly you can run Kimi K2 in Cursor using OpenRouter’s flexible model routing.

July 14, 2025