# ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 358 models through Mastra's model router. Learn more in the [OpenRouter documentation](https://openrouter.ai/models). ## Usage ```typescript import { Agent } from "@mastra/core/agent"; const agent = new Agent({ id: "my-agent", name: "My Agent", instructions: "You are a helpful assistant", model: "openrouter/ai21/jamba-large-1.7" }); ``` > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [OpenRouter documentation](https://openrouter.ai/models) for details. ## Configuration ```bash # 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 | | --------------------------------------------------------------- | | `~anthropic/claude-haiku-latest` | | `~anthropic/claude-opus-latest` | | `~anthropic/claude-sonnet-latest` | | `~google/gemini-flash-latest` | | `~google/gemini-pro-latest` | | `~moonshotai/kimi-latest` | | `~openai/gpt-latest` | | `~openai/gpt-mini-latest` | | `ai21/jamba-large-1.7` | | `aion-labs/aion-1.0` | | `aion-labs/aion-1.0-mini` | | `aion-labs/aion-2.0` | | `aion-labs/aion-rp-llama-3.1-8b` | | `alfredpros/codellama-7b-instruct-solidity` | | `alibaba/tongyi-deepresearch-30b-a3b` | | `allenai/olmo-3-32b-think` | | `amazon/nova-2-lite-v1` | | `amazon/nova-lite-v1` | | `amazon/nova-micro-v1` | | `amazon/nova-premier-v1` | | `amazon/nova-pro-v1` | | `anthracite-org/magnum-v4-72b` | | `anthropic/claude-3-haiku` | | `anthropic/claude-3.5-haiku` | | `anthropic/claude-haiku-4.5` | | `anthropic/claude-opus-4` | | `anthropic/claude-opus-4.1` | | `anthropic/claude-opus-4.5` | | `anthropic/claude-opus-4.6` | | `anthropic/claude-opus-4.6-fast` | | `anthropic/claude-opus-4.7` | | `anthropic/claude-opus-4.7-fast` | | `anthropic/claude-sonnet-4` | | `anthropic/claude-sonnet-4.5` | | `anthropic/claude-sonnet-4.6` | | `arcee-ai/coder-large` | | `arcee-ai/maestro-reasoning` | | `arcee-ai/spotlight` | | `arcee-ai/trinity-large-thinking` | | `arcee-ai/trinity-large-thinking:free` | | `arcee-ai/trinity-mini` | | `arcee-ai/virtuoso-large` | | `baidu/cobuddy:free` | | `baidu/ernie-4.5-21b-a3b` | | `baidu/ernie-4.5-21b-a3b-thinking` | | `baidu/ernie-4.5-300b-a47b` | | `baidu/ernie-4.5-vl-28b-a3b` | | `baidu/ernie-4.5-vl-424b-a47b` | | `baidu/qianfan-ocr-fast` | | `bytedance-seed/seed-1.6` | | `bytedance-seed/seed-1.6-flash` | | `bytedance-seed/seed-2.0-lite` | | `bytedance-seed/seed-2.0-mini` | | `bytedance/ui-tars-1.5-7b` | | `cognitivecomputations/dolphin-mistral-24b-venice-edition:free` | | `cohere/command-a` | | `cohere/command-r-08-2024` | | `cohere/command-r-plus-08-2024` | | `cohere/command-r7b-12-2024` | | `deepcogito/cogito-v2.1-671b` | | `deepseek/deepseek-chat` | | `deepseek/deepseek-chat-v3-0324` | | `deepseek/deepseek-chat-v3.1` | | `deepseek/deepseek-r1` | | `deepseek/deepseek-r1-0528` | | `deepseek/deepseek-r1-distill-llama-70b` | | `deepseek/deepseek-r1-distill-qwen-32b` | | `deepseek/deepseek-v3.1-terminus` | | `deepseek/deepseek-v3.2` | | `deepseek/deepseek-v3.2-exp` | | `deepseek/deepseek-v3.2-speciale` | | `deepseek/deepseek-v4-flash` | | `deepseek/deepseek-v4-flash:free` | | `deepseek/deepseek-v4-pro` | | `essentialai/rnj-1-instruct` | | `google/gemini-2.0-flash-001` | | `google/gemini-2.0-flash-lite-001` | | `google/gemini-2.5-flash` | | `google/gemini-2.5-flash-image` | | `google/gemini-2.5-flash-lite` | | `google/gemini-2.5-flash-lite-preview-09-2025` | | `google/gemini-2.5-pro` | | `google/gemini-2.5-pro-preview` | | `google/gemini-2.5-pro-preview-05-06` | | `google/gemini-3-flash-preview` | | `google/gemini-3-pro-image-preview` | | `google/gemini-3.1-flash-image-preview` | | `google/gemini-3.1-flash-lite` | | `google/gemini-3.1-flash-lite-preview` | | `google/gemini-3.1-pro-preview` | | `google/gemini-3.1-pro-preview-customtools` | | `google/gemini-3.5-flash` | | `google/gemma-2-27b-it` | | `google/gemma-3-12b-it` | | `google/gemma-3-27b-it` | | `google/gemma-3-4b-it` | | `google/gemma-3n-e4b-it` | | `google/gemma-4-26b-a4b-it` | | `google/gemma-4-26b-a4b-it:free` | | `google/gemma-4-31b-it` | | `google/gemma-4-31b-it:free` | | `google/lyria-3-clip-preview` | | `google/lyria-3-pro-preview` | | `gryphe/mythomax-l2-13b` | | `ibm-granite/granite-4.0-h-micro` | | `ibm-granite/granite-4.1-8b` | | `inception/mercury-2` | | `inclusionai/ling-2.6-1t` | | `inclusionai/ling-2.6-flash` | | `inclusionai/ring-2.6-1t` | | `inflection/inflection-3-pi` | | `inflection/inflection-3-productivity` | | `kwaipilot/kat-coder-pro-v2` | | `liquid/lfm-2-24b-a2b` | | `liquid/lfm-2.5-1.2b-instruct:free` | | `liquid/lfm-2.5-1.2b-thinking:free` | | `mancer/weaver` | | `meta-llama/llama-3-70b-instruct` | | `meta-llama/llama-3-8b-instruct` | | `meta-llama/llama-3.1-70b-instruct` | | `meta-llama/llama-3.1-8b-instruct` | | `meta-llama/llama-3.2-11b-vision-instruct` | | `meta-llama/llama-3.2-1b-instruct` | | `meta-llama/llama-3.2-3b-instruct` | | `meta-llama/llama-3.2-3b-instruct:free` | | `meta-llama/llama-3.3-70b-instruct` | | `meta-llama/llama-3.3-70b-instruct:free` | | `meta-llama/llama-4-maverick` | | `meta-llama/llama-4-scout` | | `meta-llama/llama-guard-3-8b` | | `meta-llama/llama-guard-4-12b` | | `microsoft/phi-4` | | `microsoft/phi-4-mini-instruct` | | `microsoft/wizardlm-2-8x22b` | | `minimax/minimax-01` | | `minimax/minimax-m1` | | `minimax/minimax-m2` | | `minimax/minimax-m2-her` | | `minimax/minimax-m2.1` | | `minimax/minimax-m2.5` | | `minimax/minimax-m2.5:free` | | `minimax/minimax-m2.7` | | `mistralai/codestral-2508` | | `mistralai/devstral-2512` | | `mistralai/devstral-medium` | | `mistralai/devstral-small` | | `mistralai/ministral-14b-2512` | | `mistralai/ministral-3b-2512` | | `mistralai/ministral-8b-2512` | | `mistralai/mistral-7b-instruct-v0.1` | | `mistralai/mistral-large` | | `mistralai/mistral-large-2407` | | `mistralai/mistral-large-2411` | | `mistralai/mistral-large-2512` | | `mistralai/mistral-medium-3` | | `mistralai/mistral-medium-3-5` | | `mistralai/mistral-medium-3.1` | | `mistralai/mistral-nemo` | | `mistralai/mistral-saba` | | `mistralai/mistral-small-24b-instruct-2501` | | `mistralai/mistral-small-2603` | | `mistralai/mistral-small-3.1-24b-instruct` | | `mistralai/mistral-small-3.2-24b-instruct` | | `mistralai/mixtral-8x22b-instruct` | | `mistralai/pixtral-large-2411` | | `mistralai/voxtral-small-24b-2507` | | `moonshotai/kimi-k2` | | `moonshotai/kimi-k2-0905` | | `moonshotai/kimi-k2-thinking` | | `moonshotai/kimi-k2.5` | | `moonshotai/kimi-k2.6` | | `morph/morph-v3-fast` | | `morph/morph-v3-large` | | `nex-agi/deepseek-v3.1-nex-n1` | | `nousresearch/hermes-2-pro-llama-3-8b` | | `nousresearch/hermes-3-llama-3.1-405b` | | `nousresearch/hermes-3-llama-3.1-405b:free` | | `nousresearch/hermes-3-llama-3.1-70b` | | `nousresearch/hermes-4-405b` | | `nousresearch/hermes-4-70b` | | `nvidia/llama-3.3-nemotron-super-49b-v1.5` | | `nvidia/nemotron-3-nano-30b-a3b` | | `nvidia/nemotron-3-nano-30b-a3b:free` | | `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free` | | `nvidia/nemotron-3-super-120b-a12b` | | `nvidia/nemotron-3-super-120b-a12b:free` | | `nvidia/nemotron-nano-12b-v2-vl:free` | | `nvidia/nemotron-nano-9b-v2` | | `nvidia/nemotron-nano-9b-v2:free` | | `openai/gpt-3.5-turbo` | | `openai/gpt-3.5-turbo-0613` | | `openai/gpt-3.5-turbo-16k` | | `openai/gpt-3.5-turbo-instruct` | | `openai/gpt-4` | | `openai/gpt-4-0314` | | `openai/gpt-4-1106-preview` | | `openai/gpt-4-turbo` | | `openai/gpt-4-turbo-preview` | | `openai/gpt-4.1` | | `openai/gpt-4.1-mini` | | `openai/gpt-4.1-nano` | | `openai/gpt-4o` | | `openai/gpt-4o-2024-05-13` | | `openai/gpt-4o-2024-08-06` | | `openai/gpt-4o-2024-11-20` | | `openai/gpt-4o-audio-preview` | | `openai/gpt-4o-mini` | | `openai/gpt-4o-mini-2024-07-18` | | `openai/gpt-4o-mini-search-preview` | | `openai/gpt-4o-search-preview` | | `openai/gpt-5` | | `openai/gpt-5-chat` | | `openai/gpt-5-codex` | | `openai/gpt-5-image` | | `openai/gpt-5-image-mini` | | `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-5.3-chat` | | `openai/gpt-5.3-codex` | | `openai/gpt-5.4` | | `openai/gpt-5.4-image-2` | | `openai/gpt-5.4-mini` | | `openai/gpt-5.4-nano` | | `openai/gpt-5.4-pro` | | `openai/gpt-5.5` | | `openai/gpt-5.5-pro` | | `openai/gpt-audio` | | `openai/gpt-audio-mini` | | `openai/gpt-chat-latest` | | `openai/gpt-oss-120b` | | `openai/gpt-oss-120b:free` | | `openai/gpt-oss-20b` | | `openai/gpt-oss-20b:free` | | `openai/gpt-oss-safeguard-20b` | | `openai/o1` | | `openai/o1-pro` | | `openai/o3` | | `openai/o3-deep-research` | | `openai/o3-mini` | | `openai/o3-mini-high` | | `openai/o3-pro` | | `openai/o4-mini` | | `openai/o4-mini-deep-research` | | `openai/o4-mini-high` | | `openrouter/auto` | | `openrouter/bodybuilder` | | `openrouter/free` | | `openrouter/owl-alpha` | | `openrouter/pareto-code` | | `perceptron/perceptron-mk1` | | `perplexity/sonar` | | `perplexity/sonar-deep-research` | | `perplexity/sonar-pro` | | `perplexity/sonar-pro-search` | | `perplexity/sonar-reasoning-pro` | | `poolside/laguna-m.1:free` | | `poolside/laguna-xs.2:free` | | `prime-intellect/intellect-3` | | `qwen/qwen-2.5-72b-instruct` | | `qwen/qwen-2.5-7b-instruct` | | `qwen/qwen-2.5-coder-32b-instruct` | | `qwen/qwen-plus` | | `qwen/qwen-plus-2025-07-28` | | `qwen/qwen-plus-2025-07-28:thinking` | | `qwen/qwen2.5-vl-72b-instruct` | | `qwen/qwen3-14b` | | `qwen/qwen3-235b-a22b` | | `qwen/qwen3-235b-a22b-2507` | | `qwen/qwen3-235b-a22b-thinking-2507` | | `qwen/qwen3-30b-a3b` | | `qwen/qwen3-30b-a3b-instruct-2507` | | `qwen/qwen3-30b-a3b-thinking-2507` | | `qwen/qwen3-32b` | | `qwen/qwen3-8b` | | `qwen/qwen3-coder` | | `qwen/qwen3-coder-30b-a3b-instruct` | | `qwen/qwen3-coder-flash` | | `qwen/qwen3-coder-next` | | `qwen/qwen3-coder-plus` | | `qwen/qwen3-coder:free` | | `qwen/qwen3-max` | | `qwen/qwen3-max-thinking` | | `qwen/qwen3-next-80b-a3b-instruct` | | `qwen/qwen3-next-80b-a3b-instruct:free` | | `qwen/qwen3-next-80b-a3b-thinking` | | `qwen/qwen3-vl-235b-a22b-instruct` | | `qwen/qwen3-vl-235b-a22b-thinking` | | `qwen/qwen3-vl-30b-a3b-instruct` | | `qwen/qwen3-vl-30b-a3b-thinking` | | `qwen/qwen3-vl-32b-instruct` | | `qwen/qwen3-vl-8b-instruct` | | `qwen/qwen3-vl-8b-thinking` | | `qwen/qwen3.5-122b-a10b` | | `qwen/qwen3.5-27b` | | `qwen/qwen3.5-35b-a3b` | | `qwen/qwen3.5-397b-a17b` | | `qwen/qwen3.5-9b` | | `qwen/qwen3.5-flash-02-23` | | `qwen/qwen3.5-plus-02-15` | | `qwen/qwen3.5-plus-20260420` | | `qwen/qwen3.6-27b` | | `qwen/qwen3.6-35b-a3b` | | `qwen/qwen3.6-flash` | | `qwen/qwen3.6-max-preview` | | `qwen/qwen3.6-plus` | | `qwen/qwen3.7-max` | | `rekaai/reka-edge` | | `rekaai/reka-flash-3` | | `relace/relace-apply-3` | | `relace/relace-search` | | `sao10k/l3-euryale-70b` | | `sao10k/l3-lunaris-8b` | | `sao10k/l3.1-70b-hanami-x1` | | `sao10k/l3.1-euryale-70b` | | `sao10k/l3.3-euryale-70b` | | `stepfun/step-3.5-flash` | | `switchpoint/router` | | `tencent/hunyuan-a13b-instruct` | | `tencent/hy3-preview` | | `thedrummer/cydonia-24b-v4.1` | | `thedrummer/rocinante-12b` | | `thedrummer/skyfall-36b-v2` | | `thedrummer/unslopnemo-12b` | | `undi95/remm-slerp-l2-13b` | | `upstage/solar-pro-3` | | `writer/palmyra-x5` | | `x-ai/grok-4.20` | | `x-ai/grok-4.20-multi-agent` | | `x-ai/grok-4.3` | | `x-ai/grok-build-0.1` | | `xiaomi/mimo-v2-flash` | | `xiaomi/mimo-v2-omni` | | `xiaomi/mimo-v2-pro` | | `xiaomi/mimo-v2.5` | | `xiaomi/mimo-v2.5-pro` | | `z-ai/glm-4-32b` | | `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.6v` | | `z-ai/glm-4.7` | | `z-ai/glm-4.7-flash` | | `z-ai/glm-5` | | `z-ai/glm-5-turbo` | | `z-ai/glm-5.1` | | `z-ai/glm-5v-turbo` |