Skip to main content

Ollama Cloud logoOllama 云

🌐 Ollama Cloud logoOllama Cloud

通过 Mastra 的模型路由访问 29 个 Ollama 云模型。身份验证会使用 OLLAMA_API_KEY 环境变量自动处理。

🌐 Access 29 Ollama Cloud models through Mastra's model router. Authentication is handled automatically using the OLLAMA_API_KEY environment variable.

在Ollama 云文档中了解更多信息。

🌐 Learn more in the Ollama Cloud documentation.

.env
OLLAMA_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: "ollama-cloud/cogito-2.1:671b"
});

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

Mastra 使用兼容 OpenAI 的 /chat/completions 端点。某些特定提供商的功能可能无法使用。详见 Ollama Cloud 文档。

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

模型
Direct link to 模型

🌐 Models

ModelContextToolsReasoningImageAudioVideoInput $/1MOutput $/1M
ollama-cloud/cogito-2.1:671b164K——
ollama-cloud/deepseek-v3.1:671b164K——
ollama-cloud/deepseek-v3.2164K——
ollama-cloud/devstral-2:123b262K——
ollama-cloud/devstral-small-2:24b262K——
ollama-cloud/gemini-3-flash-preview1.0M——
ollama-cloud/gemini-3-pro-preview1.0M——
ollama-cloud/gemma3:12b131K——
ollama-cloud/gemma3:27b131K——
ollama-cloud/gemma3:4b131K——
ollama-cloud/glm-4.6203K——
ollama-cloud/glm-4.7203K——
ollama-cloud/gpt-oss:120b131K——
ollama-cloud/gpt-oss:20b131K——
ollama-cloud/kimi-k2-thinking262K——
ollama-cloud/kimi-k2:1t262K——
ollama-cloud/kimi-k2.5262K——
ollama-cloud/minimax-m2205K——
ollama-cloud/minimax-m2.1205K——
ollama-cloud/ministral-3:14b262K——
ollama-cloud/ministral-3:3b262K——
ollama-cloud/ministral-3:8b262K——
ollama-cloud/mistral-large-3:675b262K——
ollama-cloud/nemotron-3-nano:30b1.0M——
ollama-cloud/qwen3-coder:480b262K——
ollama-cloud/qwen3-next:80b262K——
ollama-cloud/qwen3-vl:235b262K——
ollama-cloud/qwen3-vl:235b-instruct262K——
ollama-cloud/rnj-1:8b33K——
29 available models

高级配置
Direct link to 高级配置

🌐 Advanced Configuration

自定义头
Direct link to 自定义头

🌐 Custom Headers

src/mastra/agents/my-agent.ts
const agent = new Agent({
  id: "custom-agent",
  name: "custom-agent",
  model: {
    url: "https://ollama.com/v1",
    id: "ollama-cloud/cogito-2.1:671b",
    apiKey: process.env.OLLAMA_API_KEY,
    headers: {
      "X-Custom-Header": "value"
    }
  }
});

动态模型选择
Direct link to 动态模型选择

🌐 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
      ? "ollama-cloud/rnj-1:8b"
      : "ollama-cloud/cogito-2.1:671b";
  }
});
目录