跳到主要内容
非官方简体中文翻译,内容版权归 Mastra 所有,遵循 Apache-2.0 许可。

Nvidia logoNvidia

Access 107 Nvidia models through Mastra's model router. Authentication is handled automatically using the NVIDIA_API_KEY environment variable.

Learn more in the Nvidia documentation.

.env
NVIDIA_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: "nvidia/abacusai/dracarys-llama-3.1-70b-instruct"
});

// 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);
}
备注

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

Models
Models的直接链接

ModelContextToolsReasoningImageAudioVideoInput $/1MOutput $/1M
nvidia/baai/bge-m38K——
nvidia/black-forest-labs/flux_1-kontext-dev41K——
nvidia/black-forest-labs/flux_1-schnell77——
nvidia/black-forest-labs/flux_2-klein-4b41K——
nvidia/black-forest-labs/flux.1-dev4K——
nvidia/deepseek-ai/deepseek-v4.1-flash1.0M——
nvidia/google/diffusiongemma-26b-a4b-it250K——
nvidia/google/gemma-3-12b-it131K——
nvidia/google/gemma-3-4b-it131K——
nvidia/google/gemma-4-31b-it256K——
nvidia/google/google-paligemma128K——
nvidia/meta/esm2-650m128K——
nvidia/meta/esmfold128K——
nvidia/meta/llama-3.2-11b-vision-instruct128K——
nvidia/meta/llama-3.2-90b-vision-instruct128K——
nvidia/meta/llama-guard-4-12b128K——
nvidia/meta/muse-glimmer-30b131K——
nvidia/mistralai/magistral-small-250633K——
nvidia/mistralai/mistral-7b-instruct-v0.366K——
nvidia/mistralai/mistral-medium-3-instruct131K——
nvidia/moonshotai/kimi-k31.0M——
nvidia/nvidia/active-speaker-detection———
nvidia/nvidia/bevformer128K——
nvidia/nvidia/cosmos-predict1-5b———
nvidia/nvidia/cosmos-reason2-8b131K——
nvidia/nvidia/cosmos-transfer1-7b———
nvidia/nvidia/cosmos-transfer2_5-2b———
nvidia/nvidia/llama-3_2-nemoretriever-300m-embed-v133K——
nvidia/nvidia/llama-3.1-nemotron-70b-instruct128K——
nvidia/nvidia/llama-3.1-nemotron-safety-guard-8b-v3128K——
nvidia/nvidia/llama-3.1-nemotron-ultra-253b-v1128K——
nvidia/nvidia/llama-nemotron-embed-vl-1b-v233K——
nvidia/nvidia/llama-nemotron-rerank-vl-1b-v2128K——
nvidia/nvidia/magpie-tts-zeroshot———
nvidia/nvidia/nemotron-3-nano-omni-30b-a3b-reasoning256K——
nvidia/nvidia/nemotron-3-ultra-550b-a55b1.0M$0.50$3
nvidia/nvidia/nemotron-3.5-content-safety128K——
nvidia/nvidia/nemotron-3.5-lightning-30b-a3b262K——
nvidia/nvidia/nemotron-3.5-super-vl-120b-a12b1.0M——
nvidia/nvidia/nemotron-voicechat128K——
nvidia/nvidia/nv-embed-v133K——
nvidia/nvidia/nv-embedcode-7b-v133K——
nvidia/nvidia/rerank-qa-mistral-4b128K——
nvidia/nvidia/riva-translate-4b-instruct-v1.1128K——
nvidia/nvidia/sparsedrive128K——
nvidia/nvidia/streampetr128K——
nvidia/nvidia/studiovoice128K——
nvidia/nvidia/synthetic-video-detector———
nvidia/nvidia/usdcode128K——
nvidia/nvidia/usdvalidate———
nvidia/openai/gpt-oss-20b131K——
nvidia/openai/whisper-large-v3———
nvidia/poolside/laguna-xs-2.1262K——
nvidia/qwen/qwen-image———
nvidia/qwen/qwen-image-edit———
nvidia/stepfun-ai/step-5-preview1.0M——
nvidia/z-ai/glm-5.31.0M——
nvidia/z-ai/glm-5.3-flash1.0M——
58 available models

Model availability, capabilities, context windows, and pricing are sourced from models.dev and may change.

Advanced configuration
Advanced configuration的直接链接

Custom headers
Custom headers的直接链接

src/mastra/agents/my-agent.ts
const agent = new Agent({
id: "custom-agent",
name: "custom-agent",
model: {
url: "https://integrate.api.nvidia.com/v1",
id: "nvidia/abacusai/dracarys-llama-3.1-70b-instruct",
apiKey: process.env.NVIDIA_API_KEY,
headers: {
"X-Custom-Header": "value"
}
}
});

Dynamic model selection
Dynamic model selection的直接链接

src/mastra/agents/my-agent.ts
const agent = new Agent({
id: "dynamic-agent",
name: "Dynamic Agent",
model: ({ requestContext }) => {
const useAdvanced = requestContext.task === "complex";
return useAdvanced
? "nvidia/z-ai/glm-5.3-flash"
: "nvidia/abacusai/dracarys-llama-3.1-70b-instruct";
}
});