Environment variables
List of required environment variables for each model provider and gateway supported by Mastra's model router.
| Name | Model prefix | Environment variables |
|---|---|---|
| 302.AI | 302ai/* | 302AI_API_KEY |
| Abacus | abacus/* | ABACUS_API_KEY |
| abliteration.ai | abliteration-ai/* | ABLIT_KEY |
| Alibaba | alibaba/* | DASHSCOPE_API_KEY |
| Alibaba (China) | alibaba-cn/* | DASHSCOPE_API_KEY |
| Alibaba Coding Plan | alibaba-coding-plan/* | ALIBABA_CODING_PLAN_API_KEY |
| Alibaba Coding Plan (China) | alibaba-coding-plan-cn/* | ALIBABA_CODING_PLAN_API_KEY |
| Alibaba Token Plan | alibaba-token-plan/* | ALIBABA_TOKEN_PLAN_API_KEY |
| Alibaba Token Plan (China) | alibaba-token-plan-cn/* | ALIBABA_TOKEN_PLAN_API_KEY |
| Ambient | ambient/* | AMBIENT_API_KEY |
| Anthropic | anthropic/* | ANTHROPIC_API_KEY |
| AnyAPI | anyapi/* | ANYAPI_API_KEY |
| Atomic Chat | atomic-chat/* | ATOMIC_CHAT_API_KEY |
| Auriko | auriko/* | AURIKO_API_KEY |
| Bailing | bailing/* | BAILING_API_TOKEN |
| Baseten | baseten/* | BASETEN_API_KEY |
| Berget.AI | berget/* | BERGET_API_KEY |
| Cerebras | cerebras/* | CEREBRAS_API_KEY |
| Chutes | chutes/* | CHUTES_API_KEY |
| Clarifai | clarifai/* | CLARIFAI_PAT |
| Claudinio | claudinio/* | CLAUDINIO_API_KEY |
| CloudFerro Sherlock | cloudferro-sherlock/* | CLOUDFERRO_SHERLOCK_API_KEY |
| Cloudflare Workers AI | cloudflare-workers-ai/* | CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_API_KEY |
| Cortecs | cortecs/* | CORTECS_API_KEY |
| CrofAI | crof/* | CROF_API_KEY |
| D.Run (China) | drun/* | DRUN_API_KEY |
| Databricks | databricks/* | DATABRICKS_HOST, DATABRICKS_TOKEN |
| Deep Infra | deepinfra/* | DEEPINFRA_API_KEY |
| DeepSeek | deepseek/* | DEEPSEEK_API_KEY |
| DigitalOcean | digitalocean/* | DIGITALOCEAN_ACCESS_TOKEN |
| DInference | dinference/* | DINFERENCE_API_KEY |
| evroc | evroc/* | EVROC_API_KEY |
| FastRouter | fastrouter/* | FASTROUTER_API_KEY |
| Fireworks AI | fireworks-ai/* | FIREWORKS_API_KEY |
| FreeModel | freemodel/* | FREEMODEL_API_KEY |
| Friendli | friendli/* | FRIENDLI_TOKEN |
| FrogBot | frogbot/* | FROGBOT_API_KEY |
| GitHub Models | github-models/* | GITHUB_TOKEN |
| GMI Cloud | gmicloud/* | GMICLOUD_API_KEY |
google/* | GOOGLE_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY | |
| Groq | groq/* | GROQ_API_KEY |
| Helicone | helicone/* | HELICONE_API_KEY |
| HPC-AI | hpc-ai/* | HPC_AI_API_KEY |
| Hugging Face | huggingface/* | HF_TOKEN |
| iFlow | iflowcn/* | IFLOW_API_KEY |
| Inception | inception/* | INCEPTION_API_KEY |
| Inceptron | inceptron/* | INCEPTRON_API_KEY |
| Inference | inference/* | INFERENCE_API_KEY |
| IO.NET | io-net/* | IOINTELLIGENCE_API_KEY |
| Jiekou.AI | jiekou/* | JIEKOU_API_KEY |
| Kilo Gateway | kilo/* | KILO_API_KEY |
| Kimi For Coding | kimi-for-coding/* | KIMI_API_KEY |
| KUAE Cloud Coding Plan | kuae-cloud-coding-plan/* | KUAE_API_KEY |
| Lilac | lilac/* | LILAC_API_KEY |
| Llama | llama/* | LLAMA_API_KEY |
| LLM Gateway | llmgateway/* | LLMGATEWAY_API_KEY |
| LLMTR | llmtr/* | LLMTR_API_KEY |
| LMStudio | lmstudio/* | LMSTUDIO_API_KEY |
| LucidQuery | lucidquery/* | LUCIDQUERY_API_KEY |
| Meganova | meganova/* | MEGANOVA_API_KEY |
| MiniMax (minimax.io) | minimax/* | MINIMAX_API_KEY |
| MiniMax (minimaxi.com) | minimax-cn/* | MINIMAX_API_KEY |
| MiniMax Token Plan (minimax.io) | minimax-coding-plan/* | MINIMAX_API_KEY |
| MiniMax Token Plan (minimaxi.com) | minimax-cn-coding-plan/* | MINIMAX_API_KEY |
| Mistral | mistral/* | MISTRAL_API_KEY |
| Mixlayer | mixlayer/* | MIXLAYER_API_KEY |
| Moark | moark/* | MOARK_API_KEY |
| ModelScope | modelscope/* | MODELSCOPE_API_KEY |
| Moonshot AI | moonshotai/* | MOONSHOT_API_KEY |
| Moonshot AI (China) | moonshotai-cn/* | MOONSHOT_API_KEY |
| Morph | morph/* | MORPH_API_KEY |
| NanoGPT | nano-gpt/* | NANO_GPT_API_KEY |
| NEAR AI Cloud | nearai/* | NEARAI_API_KEY |
| Nebius Token Factory | nebius/* | NEBIUS_API_KEY |
| Neon | neon/* | NEON_AI_GATEWAY_BASE_URL, NEON_AI_GATEWAY_TOKEN |
| Neuralwatt | neuralwatt/* | NEURALWATT_API_KEY |
| Nova | nova/* | NOVA_API_KEY |
| NovitaAI | novita-ai/* | NOVITA_API_KEY |
| Nvidia | nvidia/* | NVIDIA_API_KEY |
| Ollama Cloud | ollama-cloud/* | OLLAMA_API_KEY |
| OpenAI | openai/* | OPENAI_API_KEY |
| OpenCode Go | opencode-go/* | OPENCODE_API_KEY |
| OpenCode Zen | opencode/* | OPENCODE_API_KEY |
| OrcaRouter | orcarouter/* | ORCAROUTER_API_KEY |
| OVHcloud AI Endpoints | ovhcloud/* | OVHCLOUD_API_KEY |
| Perplexity | perplexity/* | PERPLEXITY_API_KEY |
| Perplexity Agent | perplexity-agent/* | PERPLEXITY_API_KEY |
| Poe | poe/* | POE_API_KEY |
| Poolside | poolside/* | POOLSIDE_API_KEY |
| Privatemode AI | privatemode-ai/* | PRIVATEMODE_API_KEY |
| QiHang | qihang-ai/* | QIHANG_API_KEY |
| Qiniu | qiniu-ai/* | QINIU_API_KEY |
| Regolo AI | regolo-ai/* | REGOLO_API_KEY |
| Requesty | requesty/* | REQUESTY_API_KEY |
| routing.run | routing-run/* | ROUTING_RUN_API_KEY |
| Sakana AI | sakana/* | SAKANA_API_KEY |
| Sarvam AI | sarvam/* | SARVAM_API_KEY |
| Scaleway | scaleway/* | SCALEWAY_API_KEY |
| SiliconFlow | siliconflow/* | SILICONFLOW_API_KEY |
| SiliconFlow (China) | siliconflow-cn/* | SILICONFLOW_CN_API_KEY |
| Snowflake Cortex | snowflake-cortex/* | SNOWFLAKE_ACCOUNT, SNOWFLAKE_CORTEX_PAT |
| STACKIT | stackit/* | STACKIT_API_KEY |
| StepFun | stepfun/* | STEPFUN_API_KEY |
| StepFun AI | stepfun-ai/* | STEPFUN_API_KEY |
| Subconscious | subconscious/* | SUBCONSCIOUS_API_KEY |
| submodel | submodel/* | SUBMODEL_INSTAGEN_ACCESS_KEY |
| Synthetic | synthetic/* | SYNTHETIC_API_KEY |
| Tencent Coding Plan (China) | tencent-coding-plan/* | TENCENT_CODING_PLAN_API_KEY |
| Tencent TokenHub | tencent-tokenhub/* | TENCENT_TOKENHUB_API_KEY |
| The Grid AI | the-grid-ai/* | THEGRIDAI_API_KEY |
| Tinfoil | tinfoil/* | TINFOIL_API_KEY |
| Together AI | togetherai/* | TOGETHER_API_KEY |
| Umans AI | umans-ai/* | UMANS_AI_API_KEY |
| Umans AI Coding Plan | umans-ai-coding-plan/* | UMANS_AI_CODING_PLAN_API_KEY |
| Upstage | upstage/* | UPSTAGE_API_KEY |
| Vivgrid | vivgrid/* | VIVGRID_API_KEY |
| Vultr | vultr/* | VULTR_API_KEY |
| Wafer | wafer.ai/* | WAFER_API_KEY |
| Weights & Biases | wandb/* | WANDB_API_KEY |
| xAI | xai/* | XAI_API_KEY |
| Xiaomi | xiaomi/* | XIAOMI_API_KEY |
| Xiaomi Token Plan (China) | xiaomi-token-plan-cn/* | XIAOMI_API_KEY |
| Xiaomi Token Plan (Europe) | xiaomi-token-plan-ams/* | XIAOMI_API_KEY |
| Xiaomi Token Plan (Singapore) | xiaomi-token-plan-sgp/* | XIAOMI_API_KEY |
| Xpersona | xpersona/* | XPERSONA_API_KEY |
| Z.AI | zai/* | ZHIPU_API_KEY |
| Z.AI Coding Plan | zai-coding-plan/* | ZHIPU_API_KEY |
| Zeldoc | zeldoc/* | ZELDOC_API_KEY |
| ZenMux | zenmux/* | ZENMUX_API_KEY |
| Zhipu AI | zhipuai/* | ZHIPU_API_KEY |
| Zhipu AI Coding Plan | zhipuai-coding-plan/* | ZHIPU_API_KEY |
| Azure OpenAI (Gateway) | azure-openai/* | AZURE_API_KEY, AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID |
| Mastra (Gateway) | mastra/* | MASTRA_GATEWAY_API_KEY |
| Netlify (Gateway) | netlify/* | NETLIFY_TOKEN, NETLIFY_SITE_ID |
| OpenRouter (Gateway) | openrouter/* | OPENROUTER_API_KEY |
| Vercel (Gateway) | vercel/* | AI_GATEWAY_API_KEY |