--- title: 通过 RunAPI 在 WorkBuddy 中使用 Gemini — MCP 指南 | RunAPI description: 通过 RunAPI MCP 服务器在 WorkBuddy 中调用 Google Gemini。Gemini 3.5 Flash、3.x Pro、2.5 Pro——一个密钥、一份 MCP 配置，无需 Google Cloud 项目。 url: https://runapi.ai/zh-CN/workbuddy-gemini.md canonical: https://runapi.ai/zh-CN/workbuddy-gemini locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-gemini zh-CN: https://runapi.ai/zh-CN/workbuddy-gemini es: https://runapi.ai/es/workbuddy-gemini ja: https://runapi.ai/ja/workbuddy-gemini de: https://runapi.ai/de/workbuddy-gemini fr: https://runapi.ai/fr/workbuddy-gemini pt-BR: https://runapi.ai/pt-BR/workbuddy-gemini ko: https://runapi.ai/ko/workbuddy-gemini it: https://runapi.ai/it/workbuddy-gemini nl: https://runapi.ai/nl/workbuddy-gemini pl: https://runapi.ai/pl/workbuddy-gemini tr: https://runapi.ai/tr/workbuddy-gemini zh-TW: https://runapi.ai/zh-TW/workbuddy-gemini zh-HK: https://runapi.ai/zh-HK/workbuddy-gemini ar: https://runapi.ai/ar/workbuddy-gemini x-default: https://runapi.ai/workbuddy-gemini model: gemini --- > HTML version: https://runapi.ai/zh-CN/workbuddy-gemini > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Gemini Google Gemini 可通过 RunAPI 调用——Gemini 3.5 Flash 实现亚 100 毫秒首 token 延迟，3.x Pro 应对复杂推理，2.5 Pro 以 100 万 token 上下文窗口服务生产工作负载。WorkBuddy 原生支持 MCP，为 GPT 提供动力的同一个 runapi MCP 服务器和 RUNAPI_API_KEY 也能调用 Gemini。无需 Google Cloud 项目，无需服务账号，无需 Vertex AI 配置。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 RunAPI 密钥 · MCP 一键接入 · 无需 Google Cloud 项目 ### Prompt ```text 使用 runapi MCP 服务器向 Gemini 发送聊天请求。 要求： - 调用 runapi MCP 服务器提供的 RunAPI 聊天工具 - 将 model 设为 "gemini-3.5-flash" - 提问："用三句话解释 gRPC 和 REST 的区别。" - 将 temperature 设为 0.7，max_tokens 设为 256 - 展示 assistant 回复和 token 用量计数 ``` ### MCP 配置 ```bash { "mcpServers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```json { "model": "gemini-3.5-flash", "content": "gRPC 基于 HTTP/2 和 Protocol Buffers，提供强类型、多路复用的 RPC 调用并内置代码生成。REST 使用 JSON 负载，依靠 URL 路径和 HTTP 动词表达资源语义。gRPC 在服务间调用中更快；REST 更易调试，浏览器支持也更广泛。", "finish_reason": "stop", "usage": { "prompt_tokens": 34, "completion_tokens": 71, "total_tokens": 105 } } ``` ## 三步在 WorkBuddy 中使用 Gemini 1. **注册 RunAPI MCP 服务器** - 在启动 WorkBuddy 的环境中设置 RUNAPI_API_KEY，然后添加一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，使用 streamable HTTP 传输。不需要 Google Cloud 凭据，也不需要服务账号 JSON——Gemini 只认这一个 RunAPI 密钥。 `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **向工作台 agent 发出提示词** - 在 WorkBuddy 中输入自然语言请求并指明模型——gemini-3.5-flash 追求速度，gemini-2.5-pro 处理长上下文推理。WorkBuddy 会填入 RunAPI 聊天工具的 model 和 messages 参数并发起调用。 `model: gemini-3.5-flash` 3. **读取工具结果** - MCP 工具同步返回回复，附带 token 用量计数。下一条提示词就能切换到 GPT 或 Claude，配置无需改动——runapi 服务器背后的所有模型共用同一个密钥和同一套工具结构。 `usage.total_tokens: 105` ## RunAPI MCP 服务器上的 Gemini 工具参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。gemini-3.5-flash、gemini-2.5-flash、gemini-2.5-pro、gemini-3-flash-preview 或 gemini-3.1-pro-preview。 | | `messages` | `array` | 必填。消息对象数组，包含 role（system、user、assistant）和 content 字段。WorkBuddy 会根据你的提示词自动构建。 | | `temperature` | `number` | 可选。0 到 2 之间的采样温度。值越低输出越确定。默认值因模型而异。 | | `max_tokens` | `integer` | 可选。响应中生成的最大 token 数。 | | `top_p` | `number` | 可选。0 到 1 之间的核采样阈值。控制输出随机性的另一种方式，可替代 temperature。 | | `tools` | `array` | 可选。用于函数调用的工具定义。Gemini 在 assistant 消息中返回 tool_calls，WorkBuddy 会像处理其他工具结果一样处理它们。 | ## WorkBuddy 上的 Gemini 是什么？ Google Gemini 通过 RunAPI 提供，无需 Google Cloud 项目、服务账号或 Vertex AI 配置。WorkBuddy 通过与 GPT、Claude 共用的 runapi MCP 服务器和 RUNAPI_API_KEY 访问它。Gemini 3.5 Flash 为实时 agent 循环提供亚 100ms 首 token 延迟，而 Gemini 2.5 Pro 凭借 100 万 token 上下文窗口和思考模式处理复杂推理的长上下文任务。 ## Gemini 使用场景 - **工作台内的多模态分析** - 在文本提示旁发送图像、PDF、音频文件或视频帧，让 Gemini 进行分析、描述或提取结构化数据——一次工具调用即可原生处理所有输入类型。 - **100 万 token 上下文的长文档分析** - 将整个代码库、法律文档集或研究论文集输入 Gemini 2.5 Pro 的 100 万 token 上下文窗口进行分析和摘要，无需分块或检索流水线。 - **使用 Flash 的实时 agent 循环** - 将 Gemini 3.5 Flash 用于速度敏感的工具调用链——在这些场景中，亚 100ms 首 token 延迟比峰值推理质量更重要。每百万 token 成本在目录中处于最低水平之列。 ## Gemini + WorkBuddy 常见问题 ### 没有 Google Cloud 项目也能在 WorkBuddy 中使用 Google Gemini 吗？ 可以。RunAPI 通过其 MCP 服务器提供 Gemini 访问。你只需一个 RUNAPI_API_KEY——无需 Google Cloud 项目，无需服务账号 JSON，无需 Vertex AI 计费配置。 ### Gemini Flash 和 Pro 有什么区别——分别在什么时候用？ Flash（gemini-3.5-flash）最快、最便宜——适合实时 agent 循环、分类和工具调用链。Pro（gemini-2.5-pro）处理复杂推理、长上下文分析和多步任务，适合准确性比速度更重要的场景。 ### Gemini 在 RunAPI 上如何计费？ 按 token 计费的按量付费模式，无月度订阅，无最低消费。输入和输出 token 分别计量，Gemini Flash 的费率处于 RunAPI 目录中的最低水平之列。当前费率请查看 RunAPI 定价页面。 ### 我能在同一个 WorkBuddy 会话中在 Gemini 和 GPT 之间切换吗？ 可以。两者走同一个 runapi MCP 服务器和 API 密钥。在下一条提示词中指明另一个模型——gemini-3.5-flash、gpt-5.5 或目录中的任何模型——WorkBuddy 只改变工具调用中的 model 参数。 ### 通过 RunAPI 的 Gemini 支持函数调用和工具使用吗？ 支持。在请求中定义 tools，Gemini 会在 assistant 消息中返回 tool_calls。WorkBuddy 处理它们的方式与处理来自 GPT 或 Claude 的工具调用相同。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未接入？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Gemini 模型 →](https://runapi.ai/zh-CN/models/gemini.md) - 查看所有 Gemini 版本、定价层级和 API 文档。 ## 立即在 WorkBuddy 中试用 Gemini。 免费获取 RunAPI 密钥，注册 MCP 服务器，即可开始与 Gemini 3.5 Flash 对话——无需 Google Cloud 项目。 [浏览模型 →](https://runapi.ai/zh-CN/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "适用于 WorkBuddy 的 RunAPI Gemini", "applicationCategory": "DeveloperApplication", "description": "通过 RunAPI MCP 服务器在 WorkBuddy 中调用 Google Gemini。Gemini 3.5 Flash、3.x Pro、2.5 Pro——一个密钥、一份 MCP 配置，无需 Google Cloud 项目。", "url": "https://runapi.ai/zh-CN/workbuddy-gemini" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "没有 Google Cloud 项目也能在 WorkBuddy 中使用 Google Gemini 吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。RunAPI 通过其 MCP 服务器提供 Gemini 访问。你只需一个 RUNAPI_API_KEY——无需 Google Cloud 项目，无需服务账号 JSON，无需 Vertex AI 计费配置。" } }, { "@type": "Question", "name": "Gemini Flash 和 Pro 有什么区别——分别在什么时候用？", "acceptedAnswer": { "@type": "Answer", "text": "Flash（gemini-3.5-flash）最快、最便宜——适合实时 agent 循环、分类和工具调用链。Pro（gemini-2.5-pro）处理复杂推理、长上下文分析和多步任务，适合准确性比速度更重要的场景。" } }, { "@type": "Question", "name": "Gemini 在 RunAPI 上如何计费？", "acceptedAnswer": { "@type": "Answer", "text": "按 token 计费的按量付费模式，无月度订阅，无最低消费。输入和输出 token 分别计量，Gemini Flash 的费率处于 RunAPI 目录中的最低水平之列。当前费率请查看 RunAPI 定价页面。" } }, { "@type": "Question", "name": "我能在同一个 WorkBuddy 会话中在 Gemini 和 GPT 之间切换吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。两者走同一个 runapi MCP 服务器和 API 密钥。在下一条提示词中指明另一个模型——gemini-3.5-flash、gpt-5.5 或目录中的任何模型——WorkBuddy 只改变工具调用中的 model 参数。" } }, { "@type": "Question", "name": "通过 RunAPI 的 Gemini 支持函数调用和工具使用吗？", "acceptedAnswer": { "@type": "Answer", "text": "支持。在请求中定义 tools，Gemini 会在 assistant 消息中返回 tool_calls。WorkBuddy 处理它们的方式与处理来自 GPT 或 Claude 的工具调用相同。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Gemini", "description": "在 WorkBuddy 中注册 RunAPI MCP 服务器，用提示词让工作台 agent 调用 Gemini 聊天工具，并读取返回的回复。", "step": [ { "@type": "HowToStep", "position": 1, "name": "注册 RunAPI MCP 服务器", "text": "在启动 WorkBuddy 的环境中设置 RUNAPI_API_KEY，然后添加一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，使用 streamable HTTP 传输。不需要 Google Cloud 凭据，也不需要服务账号 JSON——Gemini 只认这一个 RunAPI 密钥。", "url": "https://runapi.ai/zh-CN/workbuddy-gemini#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台 agent 发出提示词", "text": "在 WorkBuddy 中输入自然语言请求并指明模型——gemini-3.5-flash 追求速度，gemini-2.5-pro 处理长上下文推理。WorkBuddy 会填入 RunAPI 聊天工具的 model 和 messages 参数并发起调用。", "url": "https://runapi.ai/zh-CN/workbuddy-gemini#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "读取工具结果", "text": "MCP 工具同步返回回复，附带 token 用量计数。下一条提示词就能切换到 GPT 或 Claude，配置无需改动——runapi 服务器背后的所有模型共用同一个密钥和同一套工具结构。", "url": "https://runapi.ai/zh-CN/workbuddy-gemini#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "适用于 WorkBuddy 的 RunAPI Gemini", "item": "https://runapi.ai/zh-CN/workbuddy-gemini" } ] } ] ```