docs/src/content/en/models/providers/deepseek.mdx
Access 2 DeepSeek models through Mastra's model router. Authentication is handled automatically using the DEEPSEEK_API_KEY environment variable.
Learn more in the DeepSeek documentation.
DEEPSEEK_API_KEY=your-api-key
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
id: "my-agent",
name: "My Agent",
instructions: "You are a helpful assistant",
model: "deepseek/deepseek-chat"
});
// 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);
}
<ProviderModelsTable models={[ { "model": "deepseek/deepseek-chat", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": false, "contextWindow": 128000, "maxOutput": 8192, "inputCost": 0.28, "outputCost": 0.42 }, { "model": "deepseek/deepseek-reasoner", "imageInput": false, "audioInput": false, "videoInput": false, "toolUsage": true, "reasoning": true, "contextWindow": 128000, "maxOutput": 64000, "inputCost": 0.28, "outputCost": 0.42 } ]} />
const agent = new Agent({
id: "custom-agent",
name: "custom-agent",
model: {
url: "https://api.deepseek.com",
id: "deepseek/deepseek-chat",
apiKey: process.env.DEEPSEEK_API_KEY,
headers: {
"X-Custom-Header": "value"
}
}
});
const agent = new Agent({
id: "dynamic-agent",
name: "Dynamic Agent",
model: ({ requestContext }) => {
const useAdvanced = requestContext.task === "complex";
return useAdvanced
? "deepseek/deepseek-reasoner"
: "deepseek/deepseek-chat";
}
});
DeepSeek supports the following provider-specific options via the providerOptions parameter:
const response = await agent.generate("Hello!", {
providerOptions: {
deepseek: {
// See available options in the table below
}
}
});
<PropertiesTable content={[ { "name": "thinking", "type": "{ type?: "enabled" | "disabled" | undefined; } | undefined", "description": "", "isOptional": true } ]} />