Netlify

Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 228 models through Mastra's model router.

Learn more in the Netlify 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: "netlify/anthropic/claude-fable-5"
});

note

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

Configuration

# Use gateway API key
NETLIFY_TOKEN=your-netlify-token
NETLIFY_SITE_ID=your-netlify-site-id

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

Available models

Model
anthropic/claude-fable-5
anthropic/claude-haiku-4-5
anthropic/claude-haiku-4-5-20251001
anthropic/claude-opus-4-5
anthropic/claude-opus-4-5-20251101
anthropic/claude-opus-4-6
anthropic/claude-opus-4-7
anthropic/claude-opus-4-8
anthropic/claude-opus-5
anthropic/claude-sonnet-4-5
anthropic/claude-sonnet-4-5-20250929
anthropic/claude-sonnet-4-6
anthropic/claude-sonnet-5
gemini/gemini-2.5-flash
gemini/gemini-2.5-flash-image
gemini/gemini-2.5-flash-lite
gemini/gemini-2.5-pro
gemini/gemini-3-flash-preview
gemini/gemini-3-pro-image
gemini/gemini-3.1-flash-image
gemini/gemini-3.1-flash-lite
gemini/gemini-3.1-flash-lite-image
gemini/gemini-3.1-pro-preview
gemini/gemini-3.1-pro-preview-customtools
gemini/gemini-3.5-flash
gemini/gemini-3.5-flash-lite
gemini/gemini-3.6-flash
gemini/gemini-3.7-flash
gemini/gemini-flash-latest
gemini/gemini-flash-lite-latest
openai/chat-latest
openai/gpt-4.1
openai/gpt-4.1-mini
openai/gpt-4.1-nano
openai/gpt-4o
openai/gpt-4o-mini
openai/gpt-5
openai/gpt-5-2025-08-07
openai/gpt-5-mini
openai/gpt-5-mini-2025-08-07
openai/gpt-5-nano
openai/gpt-5-pro
openai/gpt-5.1
openai/gpt-5.1-2025-11-13
openai/gpt-5.2
openai/gpt-5.2-2025-12-11
openai/gpt-5.2-pro
openai/gpt-5.2-pro-2025-12-11
openai/gpt-5.3-codex
openai/gpt-5.4
openai/gpt-5.4-2026-03-05
openai/gpt-5.4-mini
openai/gpt-5.4-mini-2026-03-17
openai/gpt-5.4-nano
openai/gpt-5.4-nano-2026-03-17
openai/gpt-5.4-pro
openai/gpt-5.4-pro-2026-03-05
openai/gpt-5.5
openai/gpt-5.5-2026-04-23
openai/gpt-5.5-pro
openai/gpt-5.5-pro-2026-04-23
openai/gpt-5.6-luna
openai/gpt-5.6-sol
openai/gpt-5.6-terra
openai/o3
openai/o3-mini
openai/o4-mini
openrouter/~deepseek/deepseek-v4-flash-latest
openrouter/~moonshotai/kimi-latest
openrouter/~x-ai/grok-latest
openrouter/allenai/olmo-3-32b-think
openrouter/anthracite-org/magnum-v4-72b
openrouter/arcee-ai/trinity-large-thinking
openrouter/arcee-ai/virtuoso-large
openrouter/baidu/ernie-4.5-vl-424b-a47b
openrouter/bytedance-seed/seed-1.6
openrouter/bytedance-seed/seed-1.6-flash
openrouter/bytedance-seed/seed-2-1-turbo
openrouter/bytedance-seed/seed-2.0-code
openrouter/bytedance-seed/seed-2.0-lite
openrouter/bytedance-seed/seed-2.0-mini
openrouter/bytedance/ui-tars-1.5-7b
openrouter/cognitivecomputations/dolphin-mistral-24b-venice-edition
openrouter/deepseek/deepseek-chat
openrouter/deepseek/deepseek-chat-v3-0324
openrouter/deepseek/deepseek-chat-v3.1
openrouter/deepseek/deepseek-r1
openrouter/deepseek/deepseek-r1-0528
openrouter/deepseek/deepseek-r1-distill-llama-70b
openrouter/deepseek/deepseek-v3.1-terminus
openrouter/deepseek/deepseek-v3.2
openrouter/deepseek/deepseek-v3.2-exp
openrouter/deepseek/deepseek-v4-flash
openrouter/deepseek/deepseek-v4-flash-0731
openrouter/deepseek/deepseek-v4-pro
openrouter/deepseek/deepseek-v4-pro-0813
openrouter/google/gemma-2-27b-it
openrouter/google/gemma-3-12b-it
openrouter/google/gemma-3-27b-it
openrouter/google/gemma-3-4b-it
openrouter/google/gemma-3n-e4b-it
openrouter/google/gemma-4-26b-a4b-it
openrouter/google/gemma-4-31b-it
openrouter/gryphe/mythomax-l2-13b
openrouter/ibm-granite/granite-4.1-8b
openrouter/inception/mercury-2
openrouter/inclusionai/ling-2.6-1t
openrouter/inclusionai/ling-2.6-flash
openrouter/inclusionai/ling-3.0-flash
openrouter/inclusionai/ring-2.6-1t
openrouter/mancer/weaver
openrouter/meta-llama/llama-3.1-70b-instruct
openrouter/meta-llama/llama-3.1-8b-instruct
openrouter/meta-llama/llama-3.2-3b-instruct
openrouter/meta-llama/llama-3.3-70b-instruct
openrouter/meta-llama/llama-4-maverick
openrouter/meta-llama/llama-4-scout
openrouter/meta-llama/llama-guard-4-12b
openrouter/meta/muse-glimmer-30b
openrouter/microsoft/phi-4
openrouter/microsoft/wizardlm-2-8x22b
openrouter/minimax/minimax-m1
openrouter/minimax/minimax-m2
openrouter/minimax/minimax-m2.1
openrouter/minimax/minimax-m2.5
openrouter/minimax/minimax-m2.7
openrouter/minimax/minimax-m3
openrouter/mistralai/ministral-8b
openrouter/mistralai/mistral-nemo
openrouter/mistralai/mistral-small-24b-instruct-2501
openrouter/mistralai/mistral-small-2603
openrouter/mistralai/mistral-small-3.2-24b-instruct
openrouter/moonshotai/kimi-k2
openrouter/moonshotai/kimi-k2-0905
openrouter/moonshotai/kimi-k2-thinking
openrouter/moonshotai/kimi-k2.5
openrouter/moonshotai/kimi-k2.6
openrouter/moonshotai/kimi-k2.7-code
openrouter/moonshotai/kimi-k3
openrouter/morph/morph-v3-fast
openrouter/morph/morph-v3-large
openrouter/nousresearch/hermes-3-llama-3.1-405b
openrouter/nousresearch/hermes-3-llama-3.1-70b
openrouter/nousresearch/hermes-4-405b
openrouter/nousresearch/hermes-4-70b
openrouter/nvidia/nemotron-3-nano-30b-a3b
openrouter/nvidia/nemotron-3-super-120b-a12b
openrouter/nvidia/nemotron-3-ultra-550b-a55b
openrouter/nvidia/nemotron-3.5-lightning
openrouter/openai/gpt-oss-120b
openrouter/openai/gpt-oss-20b
openrouter/openai/gpt-oss-safeguard-20b
openrouter/openrouter/auto
openrouter/openrouter/auto-beta
openrouter/openrouter/bodybuilder
openrouter/openrouter/free
openrouter/openrouter/fusion
openrouter/openrouter/pareto-code
openrouter/perceptron/perceptron-mk1
openrouter/perplexity/sonar
openrouter/perplexity/sonar-deep-research
openrouter/perplexity/sonar-pro
openrouter/perplexity/sonar-pro-search
openrouter/perplexity/sonar-reasoning-pro
openrouter/qwen/qwen-2.5-72b-instruct
openrouter/qwen/qwen-2.5-7b-instruct
openrouter/qwen/qwen2.5-vl-72b-instruct
openrouter/qwen/qwen3-14b
openrouter/qwen/qwen3-235b-a22b-2507
openrouter/qwen/qwen3-235b-a22b-thinking-2507
openrouter/qwen/qwen3-30b-a3b
openrouter/qwen/qwen3-30b-a3b-instruct-2507
openrouter/qwen/qwen3-32b
openrouter/qwen/qwen3-coder
openrouter/qwen/qwen3-coder-30b-a3b-instruct
openrouter/qwen/qwen3-coder-next
openrouter/qwen/qwen3-next-80b-a3b-instruct
openrouter/qwen/qwen3-next-80b-a3b-thinking
openrouter/qwen/qwen3-vl-235b-a22b-instruct
openrouter/qwen/qwen3-vl-235b-a22b-thinking
openrouter/qwen/qwen3-vl-30b-a3b-instruct
openrouter/qwen/qwen3-vl-8b-instruct
openrouter/qwen/qwen3.5-122b-a10b
openrouter/qwen/qwen3.5-27b
openrouter/qwen/qwen3.5-35b-a3b
openrouter/qwen/qwen3.5-397b-a17b
openrouter/qwen/qwen3.5-9b
openrouter/qwen/qwen3.6-27b
openrouter/qwen/qwen3.6-35b-a3b
openrouter/qwen/qwen3.8-2.4t-a95b
openrouter/qwen/qwen3.8-27b
openrouter/rekaai/reka-edge
openrouter/rekaai/reka-flash-3
openrouter/relace/relace-apply-3
openrouter/relace/relace-search
openrouter/sao10k/l3-lunaris-8b
openrouter/sao10k/l3.1-euryale-70b
openrouter/sao10k/l3.3-euryale-70b
openrouter/stepfun/step-3.7-flash
openrouter/tencent/hy-mt2-1.8b
openrouter/tencent/hy-mt2-30b-a3b
openrouter/tencent/hy-mt2-7b
openrouter/tencent/hy3
openrouter/thedrummer/cydonia-24b-v4.1
openrouter/thedrummer/rocinante-12b
openrouter/thedrummer/skyfall-36b-v2
openrouter/thedrummer/unslopnemo-12b
openrouter/thinkingmachines/inkling
openrouter/thinkingmachines/inkling-small
openrouter/undi95/remm-slerp-l2-13b
openrouter/x-ai/grok-4.20
openrouter/x-ai/grok-4.20-multi-agent
openrouter/x-ai/grok-4.3
openrouter/x-ai/grok-4.5
openrouter/x-ai/grok-4.6
openrouter/x-ai/grok-build-0.1
openrouter/xiaomi/mimo-v2.5
openrouter/xiaomi/mimo-v2.5-pro
openrouter/z-ai/glm-4.5-air
openrouter/z-ai/glm-4.5v
openrouter/z-ai/glm-4.6
openrouter/z-ai/glm-4.6v
openrouter/z-ai/glm-4.7
openrouter/z-ai/glm-4.7-flash
openrouter/z-ai/glm-5
openrouter/z-ai/glm-5.1
openrouter/z-ai/glm-5.2
openrouter/z-ai/glm-5.2:free