> Discover all available pages from the documentation index: https://mastra.ai/llms.txt # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 360 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/aion-labs/aion-2.0" }); ``` > **Note:** 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-fable-latest` | | `~anthropic/claude-haiku-latest` | | `~anthropic/claude-opus-latest` | | `~anthropic/claude-sonnet-latest` | | `~deepseek/deepseek-v4-flash-latest` | | `~google/gemini-flash-latest` | | `~google/gemini-pro-latest` | | `~moonshotai/kimi-latest` | | `~openai/gpt-latest` | | `~openai/gpt-mini-latest` | | `~x-ai/grok-latest` | | `~z-ai/glm-latest` | | `aion-labs/aion-2.0` | | `aion-labs/aion-3.0` | | `aion-labs/aion-3.0-mini` | | `aion-labs/aion-rp-llama-3.1-8b` | | `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-fable-5` | | `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.7` | | `anthropic/claude-opus-4.7-fast` | | `anthropic/claude-opus-4.8` | | `anthropic/claude-opus-4.8-fast` | | `anthropic/claude-opus-5` | | `anthropic/claude-opus-5-fast` | | `anthropic/claude-sonnet-4` | | `anthropic/claude-sonnet-4.5` | | `anthropic/claude-sonnet-4.6` | | `anthropic/claude-sonnet-5` | | `arcee-ai/trinity-large-thinking` | | `arcee-ai/virtuoso-large` | | `baidu/ernie-4.5-vl-424b-a47b` | | `bytedance-seed/seed-1.6` | | `bytedance-seed/seed-1.6-flash` | | `bytedance-seed/seed-2-1-turbo` | | `bytedance-seed/seed-2.0-code` | | `bytedance-seed/seed-2.0-lite` | | `bytedance-seed/seed-2.0-mini` | | `bytedance/ui-tars-1.5-7b` | | `cognitivecomputations/dolphin-mistral-24b-venice-edition` | | `cohere/command-a` | | `cohere/command-r-08-2024` | | `cohere/command-r-plus-08-2024` | | `cohere/command-r7b-12-2024` | | `cohere/north-mini-code:free` | | `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-v3.1-terminus` | | `deepseek/deepseek-v3.2` | | `deepseek/deepseek-v3.2-exp` | | `deepseek/deepseek-v4-flash` | | `deepseek/deepseek-v4-flash-0731` | | `deepseek/deepseek-v4-flash-vision-exp` | | `deepseek/deepseek-v4-pro` | | `deepseek/deepseek-v4-pro-0813` | | `dots-studio/dots-3-note-preview:free` | | `google/gemini-2.5-flash` | | `google/gemini-2.5-flash-image` | | `google/gemini-2.5-flash-lite` | | `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` | | `google/gemini-3-pro-image-preview` | | `google/gemini-3.1-flash-image` | | `google/gemini-3.1-flash-image-preview` | | `google/gemini-3.1-flash-lite` | | `google/gemini-3.1-flash-lite-image` | | `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/gemini-3.5-flash-lite` | | `google/gemini-3.6-flash` | | `google/gemini-3.7-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/ling-3.0-flash` | | `inclusionai/ring-2.6-1t` | | `kwaipilot/kat-coder-air-v2.5` | | `kwaipilot/kat-coder-pro-v2` | | `kwaipilot/kat-coder-pro-v2.5` | | `liquid/lfm-2.5-2.6b:free` | | `mancer/weaver` | | `meituan/longcat-2.0` | | `meta-llama/llama-3.1-70b-instruct` | | `meta-llama/llama-3.1-8b-instruct` | | `meta-llama/llama-3.2-1b-instruct` | | `meta-llama/llama-3.2-3b-instruct` | | `meta-llama/llama-3.3-70b-instruct` | | `meta-llama/llama-4-maverick` | | `meta-llama/llama-4-scout` | | `meta-llama/llama-guard-4-12b` | | `meta/muse-glimmer-30b` | | `meta/muse-spark-1.1` | | `meta/muse-spark-1.2` | | `meta/muse-spark-1.2-contributor` | | `microsoft/phi-4` | | `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.7` | | `minimax/minimax-m3` | | `mistralai/codestral-2508` | | `mistralai/ministral-14b-2512` | | `mistralai/ministral-3b-2512` | | `mistralai/ministral-8b` | | `mistralai/ministral-8b-2512` | | `mistralai/mistral-large` | | `mistralai/mistral-large-2407` | | `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/voxtral-small-24b-2507` | | `moonshotai/kimi-k2` | | `moonshotai/kimi-k2-0905` | | `moonshotai/kimi-k2-thinking` | | `moonshotai/kimi-k2.5` | | `moonshotai/kimi-k2.6` | | `moonshotai/kimi-k2.7-code` | | `moonshotai/kimi-k3` | | `morph/morph-v3-fast` | | `morph/morph-v3-large` | | `nex-agi/nex-n2-mini` | | `nex-agi/nex-n2-pro` | | `nousresearch/hermes-3-llama-3.1-405b` | | `nousresearch/hermes-3-llama-3.1-70b` | | `nousresearch/hermes-4-405b` | | `nousresearch/hermes-4-70b` | | `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-3-ultra-550b-a55b` | | `nvidia/nemotron-3-ultra-550b-a55b:free` | | `nvidia/nemotron-3.5-content-safety:free` | | `nvidia/nemotron-3.5-lightning` | | `nvidia/nemotron-3.5-lightning:free` | | `nvidia/nemotron-nano-12b-v2-vl:free` | | `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-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-mini` | | `openai/gpt-4o-mini-2024-07-18` | | `openai/gpt-5` | | `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-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-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-5.6-luna` | | `openai/gpt-5.6-luna-pro` | | `openai/gpt-5.6-sol` | | `openai/gpt-5.6-sol-pro` | | `openai/gpt-5.6-terra` | | `openai/gpt-5.6-terra-pro` | | `openai/gpt-audio` | | `openai/gpt-audio-mini` | | `openai/gpt-chat-latest` | | `openai/gpt-oss-120b` | | `openai/gpt-oss-20b` | | `openai/gpt-oss-safeguard-20b` | | `openai/o1` | | `openai/o1-pro` | | `openai/o3` | | `openai/o3-mini` | | `openai/o3-mini-high` | | `openai/o3-pro` | | `openai/o4-mini` | | `openai/o4-mini-high` | | `openrouter/auto` | | `openrouter/bodybuilder` | | `openrouter/free` | | `openrouter/fusion` | | `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-s-2.1` | | `poolside/laguna-s-2.1:free` | | `poolside/laguna-xs-2.1` | | `poolside/laguna-xs-2.1:free` | | `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-max` | | `qwen/qwen3-max-thinking` | | `qwen/qwen3-next-80b-a3b-instruct` | | `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-flash` | | `qwen/qwen3.7-max` | | `qwen/qwen3.7-plus` | | `qwen/qwen3.8-2.4t-a95b` | | `qwen/qwen3.8-27b` | | `qwen/qwen3.8-max` | | `rekaai/reka-edge` | | `rekaai/reka-flash-3` | | `relace/relace-apply-3` | | `relace/relace-search` | | `sakana/fugu-ultra` | | `sakana/sakana-namazu` | | `sao10k/l3-lunaris-8b` | | `sao10k/l3.1-euryale-70b` | | `sao10k/l3.3-euryale-70b` | | `stealth/ox-alpha` | | `stepfun/step-3.5-flash` | | `stepfun/step-3.7-flash` | | `tencent/hunyuan-a13b-instruct` | | `tencent/hy-mt2-1.8b` | | `tencent/hy-mt2-30b-a3b` | | `tencent/hy-mt2-7b` | | `tencent/hy3` | | `tencent/hy3-preview` | | `thedrummer/cydonia-24b-v4.1` | | `thedrummer/rocinante-12b` | | `thedrummer/skyfall-36b-v2` | | `thedrummer/unslopnemo-12b` | | `thinkingmachines/inkling` | | `thinkingmachines/inkling-small` | | `thinkingmachines/inkling-small:free` | | `thinkingmachines/inkling:free` | | `undi95/remm-slerp-l2-13b` | | `upstage/solar-pro-3` | | `upstage/solar-pro4` | | `writer/palmyra-x5` | | `x-ai/grok-4.20` | | `x-ai/grok-4.20-multi-agent` | | `x-ai/grok-4.3` | | `x-ai/grok-4.5` | | `x-ai/grok-4.6` | | `x-ai/grok-build-0.1` | | `xiaomi/mimo-v2.5` | | `xiaomi/mimo-v2.5-pro` | | `z-ai/glm-4.5` | | `z-ai/glm-4.5-air` | | `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-5.2` | | `z-ai/glm-5.2:free` | | `z-ai/glm-5.3` | | `z-ai/glm-5v-turbo` |