SandBase
Access 10 SandBase models through Mastra's model router. Authentication is handled automatically using the SANDBASE_API_KEY environment variable.
Learn more in the SandBase documentation.
.env
SANDBASE_API_KEY=your-api-key
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: "sandbase/alibaba/qwen3.7-max"
});
// Generate a response
const response = await agent.generate("Hello!");
// Stream a response
const stream = await agent.stream("Tell me a story");
for await (const chunk of stream) {
console.log(chunk);
}
note
Mastra uses the OpenAI-compatible /chat/completions endpoint. Some provider-specific features may not be available. Check the SandBase documentation for details.
ModelsDirect link to Models
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|---|---|---|---|---|---|---|---|---|
sandbase/alibaba/qwen3.7-max | 1.0M | $3 | $8 | |||||
sandbase/alibaba/qwen3.7-plus | 1.0M | $0.40 | $2 | |||||
sandbase/deepseek/deepseek-v4-flash | 1.0M | $0.30 | $1 | |||||
sandbase/deepseek/deepseek-v4-pro | 1.0M | $1 | $4 | |||||
sandbase/moonshotai/kimi-k3 | 1.0M | $3 | $15 | |||||
sandbase/openai/gpt-5.6-luna | 1.1M | $0.20 | $1 | |||||
sandbase/openai/gpt-5.6-sol | 1.1M | $4 | $20 | |||||
sandbase/openai/gpt-5.6-terra | 1.1M | $2 | $12 | |||||
sandbase/z-ai/glm-5.3 | 1.0M | $1 | $4 | |||||
sandbase/z-ai/glm-5.3-flash | 1.0M | $0.15 | $0.50 |
Model availability, capabilities, context windows, and pricing are sourced from models.dev and may change.
Advanced configurationDirect link to Advanced configuration
Custom headersDirect link to Custom headers
src/mastra/agents/my-agent.ts
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
id: "custom-agent",
name: "custom-agent",
model: {
url: "https://api.sandbase.ai/v1",
id: "sandbase/alibaba/qwen3.7-max",
apiKey: process.env.SANDBASE_API_KEY,
headers: {
"X-Custom-Header": "value"
}
}
});
Dynamic model selectionDirect link to Dynamic model selection
src/mastra/agents/my-agent.ts
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
id: "dynamic-agent",
name: "Dynamic Agent",
model: ({ requestContext }) => {
const useAdvanced = requestContext.task === "complex";
return useAdvanced
? "sandbase/z-ai/glm-5.3-flash"
: "sandbase/alibaba/qwen3.7-max";
}
});