OpenRouter

OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 173 models through Mastra's model router.

Learn more in the OpenRouter documentation.

Usage

src/mastra/agents/my-agent.ts

import { Agent } from "@mastra/core/agent";

const agent = new Agent({
  id: "my-agent",
  name: "My Agent",
  instructions: "You are a helpful assistant",
  model: "openrouter/allenai/molmo-2-8b:free"
});

info

Mastra uses the OpenAI-compatible /chat/completions endpoint. Some provider-specific features may not be available. Check the OpenRouter documentation for details.

Configuration

# Use gateway API key
OPENROUTER_API_KEY=your-gateway-key

# Or use provider API keys directly
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=ant-...

Available Models

Model
allenai/molmo-2-8b:free
anthropic/claude-3.5-haiku
anthropic/claude-3.7-sonnet
anthropic/claude-haiku-4.5
anthropic/claude-opus-4
anthropic/claude-opus-4.1
anthropic/claude-opus-4.5
anthropic/claude-sonnet-4
anthropic/claude-sonnet-4.5
arcee-ai/trinity-large-preview:free
arcee-ai/trinity-mini:free
black-forest-labs/flux.2-flex
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-max
black-forest-labs/flux.2-pro
bytedance-seed/seedream-4.5
cognitivecomputations/dolphin-mistral-24b-venice-edition:free
cognitivecomputations/dolphin3.0-mistral-24b
cognitivecomputations/dolphin3.0-r1-mistral-24b
deepseek/deepseek-chat-v3-0324
deepseek/deepseek-chat-v3.1
deepseek/deepseek-r1-0528-qwen3-8b:free
deepseek/deepseek-r1-0528:free
deepseek/deepseek-r1-distill-llama-70b
deepseek/deepseek-r1-distill-qwen-14b
deepseek/deepseek-r1:free
deepseek/deepseek-v3-base:free
deepseek/deepseek-v3.1-terminus
deepseek/deepseek-v3.1-terminus:exacto
deepseek/deepseek-v3.2
deepseek/deepseek-v3.2-speciale
featherless/qwerky-72b
google/gemini-2.0-flash-001
google/gemini-2.0-flash-exp:free
google/gemini-2.5-flash
google/gemini-2.5-flash-lite
google/gemini-2.5-flash-lite-preview-09-2025
google/gemini-2.5-flash-preview-09-2025
google/gemini-2.5-pro
google/gemini-2.5-pro-preview-05-06
google/gemini-2.5-pro-preview-06-05
google/gemini-3-flash-preview
google/gemini-3-pro-preview
google/gemma-2-9b-it
google/gemma-3-12b-it
google/gemma-3-12b-it:free
google/gemma-3-27b-it
google/gemma-3-27b-it:free
google/gemma-3-4b-it
google/gemma-3-4b-it:free
google/gemma-3n-e2b-it:free
google/gemma-3n-e4b-it
google/gemma-3n-e4b-it:free
kwaipilot/kat-coder-pro:free
liquid/lfm-2.5-1.2b-instruct:free
liquid/lfm-2.5-1.2b-thinking:free
meta-llama/llama-3.1-405b-instruct:free
meta-llama/llama-3.2-11b-vision-instruct
meta-llama/llama-3.2-3b-instruct:free
meta-llama/llama-3.3-70b-instruct:free
meta-llama/llama-4-scout:free
microsoft/mai-ds-r1:free
minimax/minimax-01
minimax/minimax-m1
minimax/minimax-m2
minimax/minimax-m2.1
mistralai/codestral-2508
mistralai/devstral-2512
mistralai/devstral-2512:free
mistralai/devstral-medium-2507
mistralai/devstral-small-2505
mistralai/devstral-small-2505:free
mistralai/devstral-small-2507
mistralai/mistral-7b-instruct:free
mistralai/mistral-medium-3
mistralai/mistral-medium-3.1
mistralai/mistral-nemo:free
mistralai/mistral-small-3.1-24b-instruct
mistralai/mistral-small-3.2-24b-instruct
mistralai/mistral-small-3.2-24b-instruct:free
moonshotai/kimi-dev-72b:free
moonshotai/kimi-k2
moonshotai/kimi-k2-0905
moonshotai/kimi-k2-0905:exacto
moonshotai/kimi-k2-thinking
moonshotai/kimi-k2:free
moonshotai/kimi-k2.5
nousresearch/deephermes-3-llama-3-8b-preview
nousresearch/hermes-3-llama-3.1-405b:free
nousresearch/hermes-4-405b
nousresearch/hermes-4-70b
nvidia/nemotron-3-nano-30b-a3b:free
nvidia/nemotron-nano-12b-v2-vl:free
nvidia/nemotron-nano-9b-v2
nvidia/nemotron-nano-9b-v2:free
openai/gpt-4.1
openai/gpt-4.1-mini
openai/gpt-4o-mini
openai/gpt-5
openai/gpt-5-chat
openai/gpt-5-codex
openai/gpt-5-image
openai/gpt-5-mini
openai/gpt-5-nano
openai/gpt-5-pro
openai/gpt-5.1
openai/gpt-5.1-chat
openai/gpt-5.1-codex
openai/gpt-5.1-codex-max
openai/gpt-5.1-codex-mini
openai/gpt-5.2
openai/gpt-5.2-chat
openai/gpt-5.2-codex
openai/gpt-5.2-pro
openai/gpt-oss-120b
openai/gpt-oss-120b:exacto
openai/gpt-oss-120b:free
openai/gpt-oss-20b
openai/gpt-oss-20b:free
openai/gpt-oss-safeguard-20b
openai/o4-mini
openrouter/sherlock-dash-alpha
openrouter/sherlock-think-alpha
qwen/qwen-2.5-coder-32b-instruct
qwen/qwen-2.5-vl-7b-instruct:free
qwen/qwen2.5-vl-32b-instruct:free
qwen/qwen2.5-vl-72b-instruct
qwen/qwen2.5-vl-72b-instruct:free
qwen/qwen3-14b:free
qwen/qwen3-235b-a22b-07-25
qwen/qwen3-235b-a22b-07-25:free
qwen/qwen3-235b-a22b-thinking-2507
qwen/qwen3-235b-a22b:free
qwen/qwen3-30b-a3b-instruct-2507
qwen/qwen3-30b-a3b-thinking-2507
qwen/qwen3-30b-a3b:free
qwen/qwen3-32b:free
qwen/qwen3-4b:free
qwen/qwen3-8b:free
qwen/qwen3-coder
qwen/qwen3-coder-30b-a3b-instruct
qwen/qwen3-coder-flash
qwen/qwen3-coder:exacto
qwen/qwen3-coder:free
qwen/qwen3-max
qwen/qwen3-next-80b-a3b-instruct
qwen/qwen3-next-80b-a3b-instruct:free
qwen/qwen3-next-80b-a3b-thinking
qwen/qwq-32b:free
rekaai/reka-flash-3
sarvamai/sarvam-m:free
sourceful/riverflow-v2-fast-preview
sourceful/riverflow-v2-max-preview
sourceful/riverflow-v2-standard-preview
thudm/glm-z1-32b:free
tngtech/deepseek-r1t2-chimera:free
tngtech/tng-r1t-chimera:free
x-ai/grok-3
x-ai/grok-3-beta
x-ai/grok-3-mini
x-ai/grok-3-mini-beta
x-ai/grok-4
x-ai/grok-4-fast
x-ai/grok-4.1-fast
x-ai/grok-code-fast-1
z-ai/glm-4.5
z-ai/glm-4.5-air
z-ai/glm-4.5-air:free
z-ai/glm-4.5v
z-ai/glm-4.6
z-ai/glm-4.6:exacto
z-ai/glm-4.7
z-ai/glm-4.7-flash