Model Providers

Mastra’s unified model router gives you access to 541+ models from 38 providers with a single API. Switch between models and providers without changing your code. Automatic environment variable detection handles authentication, while TypeScript provides full autocomplete for every model.

Quick Start

Simply use the provider/model string pattern:

import { Agent } from "@mastra/core";
 
const agent = new Agent({
  name: "WeatherAgent",
  instructions: "You are a helpful weather assistant",
  model: "openai/gpt-4o"
});
 
const result = await agent.generate("What is the weather like?");

Browse Providers

Configuration

Models automatically detect API keys from environment variables.

AI SDK Compatibility

While Mastra provides built-in support for 541+ models, you can also use Vercel AI SDK  model providers for additional flexibility:

import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core";
 
const agent = new Agent({
  name: "AISDKAgent",
  model: openai("gpt-4-turbo")  // AI SDK model provider
});

Learn More

• 📚 Browse All Model Providers - Complete list with examples
• 🚀 Agent Documentation - Using models with agents
• ⚙️ Environment Variables - Configuration guide
• 🔧 Tool Configuration - Adding tools to agents