Google AI Studio 与 Hermes Agent：Gemini API 中文接入指南

核对日期：2026 年 9 月 28 日。本文介绍自建 Hermes Agent 通过 Google AI Studio 密钥调用 Gemini API 的流程；模型可用性、额度和界面以官方当前显示为准。

Google AI Studio、Gemini CLI 与模型有什么区别？

要让 Hermes 使用 Gemini，你需要准备 API key、选定模型，并把它们配置到运行 Hermes 的环境里。AI Studio 是准备密钥和试验提示词的入口；Hermes 负责将模型与自己的工具、会话及任务流程连接起来。

Gemini CLI 官方文档介绍的是另一套终端工具。想在 Hermes 中使用 Gemini 模型，可以直接按下文配置 API，无需先走 Gemini CLI 的安装流程。

第一步：在 Google AI Studio 获取 Gemini API key

1. 打开 Google AI Studio 的 API 密钥页面，登录自己的 Google 账号，并按页面要求完成首次使用设置。
2. 确认密钥所属的 Google Cloud 项目。新用户可能已有默认项目；已有 Cloud 项目的用户，可在项目页面导入希望使用的项目。
3. 点击创建 API 密钥，选择对应项目，再复制新密钥。按钮不可用时，检查项目权限，或请项目管理员协助。
4. 记下项目名称，之后用它核对用量、配额与账单。把密钥存入安全位置，不要粘贴到公开帖子或机器人聊天中。

具体操作可对照 Google 的API 密钥管理说明。创建密钥并不等于获得无限调用额度，也不会自动让任何模型都对该项目开放。

中文界面不代表所有地区都可使用该服务。开始前，检查 Google 公布的AI Studio 与 Gemini API 可用地区和账号要求，并确认运行 Hermes 的服务器能够访问服务。

第二步：把密钥配置到自建 Hermes

尚未安装的读者，可以先完成Hermes 中文安装教程。以下操作在实际运行 Hermes 的电脑或服务器上进行。默认目录中，密钥放在 ~/.hermes/.env，普通设置放在 ~/.hermes/config.yaml，见官方配置说明。

用编辑器打开已有的 .env，新增或更新下面这一项，保留其他设置。将占位文字替换为自己的密钥；不要原样复制占位值。

GOOGLE_API_KEY=替换为你的_Gemini_API_密钥

Hermes 也接受 GEMINI_API_KEY。选用其中一个变量即可，避免同时留下两把不同项目的密钥。如果使用了独立 profile，应在该 profile 的环境中配置，不能假定默认目录里的密钥会自动生效。

密钥只保存在你控制的运行环境中；不要放进前端页面或提交到 Git。只在笔记本终端设置变量，也不会自动配置另一台服务器上的 Hermes。

第三步：选择 Gemini 提供商与模型

保存密钥后，在终端执行：

hermes model

按Hermes 官方 Gemini 接入指南，在更多提供商中选择 Google AI Studio，再从当前列表选择模型。菜单文案可能随版本调整，关键是使用 Gemini 的 API key 接入。

核对生成的配置时，提供商字段应为 gemini，默认模型使用 Google 原生模型 ID。下面展示字段格式，其中模型 ID 必须替换为你在选择器中确认可用的值：

model:
  provider: gemini
  default: 替换为当前可用的模型ID
  base_url: https://generativelanguage.googleapis.com/v1beta

官方推荐原生 Gemini 接口。不要将其他教程中的 /openai/ 兼容接口地址直接套入这套配置，也不要把 OpenRouter 的 google/模型名 当作原生模型 ID。若从旧配置迁移，检查是否还留有 GEMINI_BASE_URL 覆盖项。

先选一个可用模型完成短任务，再用同一份输入比较质量、耗时和用量。模型名称相近不代表支持相同功能；需要图片输入或工具调用时，应分别验证。

第四步：验证对话，再验证工具任务

先运行诊断，再开启新对话：

hermes doctor
hermes chat

请用三条中文要点说明：模型、API 和智能体分别负责什么。

能收到回答后，再选择一个已启用、容易核对的工具任务，例如让它读取你准备的测试文本并生成摘要。普通对话成功，只能证明这次模型调用可用；文件权限、搜索服务和消息渠道仍需各自配置。

不要在验证时要求助手回显密钥。分享错误信息前，遮住凭据。进一步配置可从Hermes 中文文档导读查找对应章节。

免费额度、订阅和托管费用怎样区分？

Gemini API 的限制与项目、模型和使用层级有关。一次 Hermes 任务可能包含多次模型调用，长上下文和连续工具任务会更快消耗额度。先观察实际用量，再安排定时任务或长时间运行的助手。

Google 的速率限制说明列出了请求数、令牌数等限制维度；在 AI Studio 中查看自己项目的实际限制。不要把“有免费层”理解成“所有模型免费且不限量”。

Google AI Pro、Ultra 等消费端订阅，不能直接当作 Hermes 的 Gemini API 额度。Hermes 的提供商文档将 Gemini 接入明确列为 API key 路径。服务器或托管实例费用也应与 API 用量分开计算。

连接失败时，按错误类型排查

接好模型后，从一个日常任务开始

可以先让 Hermes 整理一份中文会议记录，或根据你提供的材料生成周报草稿。确认结果可核对后，再加入技能、消息入口或定时执行。更多示例见Hermes Agent 使用场景。

如果希望把助手放到持续在线的环境，可以了解Hermes 托管方案，并在仪表盘确认模型与自带密钥选项。本文的自建配置不代表托管实例开放相同设置；先确认调用渠道，再决定使用自己的 Gemini API key 还是其他模型服务。

常见问题

相关阅读

• Hermes Agent 中文安装教程
• Hermes 安装与部署导读
• Hermes 官方文档中文导读
• Hermes CLI 命令指南
• Hermes 模型与托管费用说明
• Hermes Agent 实用场景