酒馆接 Gemini API：申请 Key、免费额度与地区报错（2026）

结论先说：酒馆接 Gemini 只要三步——在 Google AI Studio 免费创建 API Key，在酒馆的 API Connections 里选 Chat Completion 和 Google AI Studio，粘贴 Key 后点 Connect。Flash 系列有免费额度。难点在网络：Gemini API 不支持中国大陆和香港，运行酒馆的那台设备必须走日本、新加坡等受支持地区的出口。

还没装酒馆的话，先看 酒馆新手 30 分钟上手 和 电脑安装教程，本文不重复安装步骤。

前置条件

账号

你需要一个 Google 账号。按 Gemini API 可用地区页，Google AI Studio 与 Gemini API 支持约 230 个国家和地区，不含中国大陆、香港、澳门，台湾在列，且要求用户年满 18 岁。该服务官方支持地区不含中国大陆，账号地区与网络出口不一致可能触发风控或封号，请你自行评估风险。

酒馆版本

截至 2026-11-05，酒馆稳定版是 1.19.0（2026-09-14 发布）。这一版的 Google AI Studio 来源会从接口拉取完整模型列表，新出的 Flash 模型一般能直接在下拉里看到。

网络环境

这是接 Gemini 最容易卡住的一步。酒馆分两部分：你在浏览器里看到的界面，和在后台运行的 Node 服务端。发给 Gemini 的请求由服务端发出，Google 按这台设备的出口 IP 判断地区。所以：

• 酒馆装在电脑上，就是电脑要有海外出口；装在安卓 Termux 里，就是手机要有。
• 出口要选日本、新加坡、韩国或美国，不要选香港，香港不在支持名单内。
• 加速器不要用「自动选择节点」，它可能连到香港；手动选定一个地区后长期固定。

只用浏览器打开 AI Studio 能成功，不代表酒馆服务端也走了同一个出口，下文「浏览器能开、酒馆连不上」一节会讲怎么处理。

怎么申请 Gemini API Key？

在 Google AI Studio 点一次按钮就能拿到 Key，不需要绑卡。

1. 在已切到受支持地区出口的浏览器里打开 aistudio.google.com，登录 Google 账号。
2. 点左侧的 Get API key（部分界面显示为 Create API key），新建或选择一个项目，生成后复制保存。
3. Key 等同于密码，不要发到群里或截图外传。泄露后到 AI Studio 删除并重建。

限额按项目计算，不按 Key 计算。同一个项目多建几个 Key 不会多出免费额度。

酒馆里怎么填？

按 SillyTavern 官方 Google 文档，路径是：

1. 点顶部插头图标打开 API Connections。
2. API 选 Chat Completion。
3. Chat Completion Source 选 Google AI Studio（旧版本叫 MakerSuite）。
4. 把 Key 粘贴到 API Key 框，点 Connect，状态灯变绿即连接成功。
5. 在模型下拉里选 Flash 系列，点 Test Message 发一条测试消息。

Test Message 会真实发出一次请求，计入额度。另一个入口 Google Vertex AI 需要 Google Cloud 项目和结算账号，个人用户先用 AI Studio 就够了。

免费额度有多少？

结论：Flash 系列免费，但每天能聊多少句要看你自己项目的上限，网上的数字互相矛盾。

官方限额说明已不再公布固定的逐模型表格，只说限额按项目计算、在 AI Studio 的 Rate limit 页查看。第三方记录差别很大：有的写 Gemini 3.8 Flash 免费层每分钟 5 次、每天 20 次，有的写每天约 1500 次。超出后返回 429，每日额度按太平洋时间午夜重置，冬令时约为北京时间 16:00。

模型	免费层	付费标准价（美元/百万 token，输入/输出）	适合
Gemini 3.8 Flash	有，次数以 AI Studio 为准	0.75 / 3.75（2027-01-01 起 1.50 / 7.50）	日常角色聊天
Flash-Lite 系列	有，第三方记录约 500 次/日	更低	额度紧张时备用
Gemini 3.1 Pro Preview	无	2 / 12	长剧情、复杂设定
Gemini 4 Argon	无	2 / 10（2026-12-01 起 4 / 20）	追求效果、不在意成本

价格来自 Gemini API 定价页。按 1 美元约 6.7 元粗算，用 3.8 Flash 付费聊一轮（约 8000 token 上下文、500 token 回复）约 0.008 美元，约 5 分钱人民币。

还要注意隐私：按 Gemini API 附加条款，在欧洲经济区、瑞士、英国以外，免费层的内容和回复可能被用于改进 Google 产品，并可能有人工审阅。官方建议免费层不要发送敏感信息。角色聊天里如果写了真实姓名、住址，最好换掉。更多见 AI 陪伴的隐私与防沉迷。

想开付费层，要在 AI Studio 里点 Set up billing 建 Google Cloud 结算账号并绑定外币卡，新账户默认预付，余额用完返回 402。国内用户的付费难点见 海外 AI App 怎么付费。

报 User location is not supported 怎么办？

这是 400 FAILED_PRECONDITION 错误，意思是 Google 认为请求来自不支持的地区。它在你发第一句话时就出现，和额度无关。按这个顺序排查：

1. 确认节点不是香港：香港、澳门、中国大陆都会触发这个错误。
2. 确认是服务端在走海外出口：见下一节。
3. 换同地区的另一个节点：Google 对部分机房 IP 段的判断和公开 IP 库不一致，日本 IP 也可能被误判。Google 开发者论坛有多例，版主会引导填写地区问题反馈表。
4. 检查付款资料：有用户反馈 Google Payments 里存在不支持地区的付款资料时也会被拒。

浏览器能开 AI Studio，酒馆却连不上？

因为酒馆服务端默认不走系统的网络设置。SillyTavern 维护者在 GitHub issue #3234 里确认，服务端发请求不读系统层面的转发设置，需要在 config.yaml 的 requestProxy 里配置。两种处理方法：

• 先切全局模式：把加速器从智能分流切到全局模式，重启酒馆再点 Connect。能连上就说明之前是服务端没走海外出口。
• 配置 requestProxy：如果你的加速器客户端提供本地端口，在酒馆根目录的 config.yaml 里写：

requestProxy:
 enabled: true
 url: http://127.0.0.1:端口号
 bypass:
 - localhost
 - 127.0.0.1

改的是根目录的 config.yaml，不是 default/ 文件夹里的那份，改完要重启酒馆。官方提醒 requestProxy 与私有地址白名单功能冲突，不确定时保持关闭，优先用全局模式。

回复是空的或被拦截怎么办？

空回复多半是设置问题，PROHIBITED_CONTENT 则是改不了的规则拦截。

有第三方读过 1.19.0 源码后指出，这一版按 Gemini 3.6、3.7 Flash 的规则发请求，用 3.8 Flash 时如果推理强度（Reasoning Effort）设成 Minimum 或开了预填，可能返回「no candidate」「Candidate text empty」。建议推理强度不用 Minimum、关闭预填，并调大 Max Response Length，因为思考过程和回复共用这个上限。

PROHIBITED_CONTENT 是 Google 内置的安全拦截，官方文档写明开发者无法调整。酒馆只是聊天前端，不改变模型的内容规则，本站也不提供任何「破限」预设。其他报错见 酒馆常见报错汇总。

常见问题

酒馆接 Gemini 要花钱吗？ 可以先不花。AI Studio 的 Key 默认走免费层，Flash 系列免费；Argon 和 3.1 Pro 只在付费层。

免费额度一天能聊多少句？ 官方不再公布固定表格，第三方说法从几十到上千次不等，以 AI Studio 的 Rate limit 页为准。

为什么报 User location is not supported？ 运行酒馆的设备出口不在支持地区。换日本、新加坡、韩国或美国节点，不要用香港。

浏览器能开 AI Studio，酒馆却连不上？ 酒馆服务端默认不走系统网络设置，切全局模式或配置 requestProxy。

免费层聊天内容会被看到吗？ 在欧洲经济区、瑞士、英国以外可能被用于改进产品并有人工审阅，不要发敏感信息。

用了酒馆内容规则会变宽松吗？ 不会，规则由 Google 决定。

中国手机号注册的 Google 账号能用吗？ 官方没有说明，账号地区与出口不一致有风控风险，请自行评估。

参考来源

• SillyTavern 官方文档 · Google Gemini 连接：https://docs.sillytavern.app/usage/api-connections/google/
• SillyTavern 官方文档 · config.yaml（requestProxy）：https://docs.sillytavern.app/administration/config-yaml/
• SillyTavern GitHub issue #3234（服务端不走系统网络设置）：https://github.com/SillyTavern/SillyTavern/issues/3234
• SillyTavern 1.19.0 发布页：https://github.com/SillyTavern/SillyTavern/releases/tag/1.19.0
• Gemini API 可用地区：https://ai.google.dev/gemini-api/docs/available-regions
• Gemini API 限额说明：https://ai.google.dev/gemini-api/docs/rate-limits
• Gemini API 定价：https://ai.google.dev/gemini-api/docs/pricing
• Gemini API 附加条款：https://ai.google.dev/gemini-api/terms
• Gemini API 排错指南：https://ai.google.dev/gemini-api/docs/troubleshooting
• Google AI 开发者论坛 · 地区限制讨论：https://discuss.ai.google.dev/t/api-access-issue-region-restriction/107160
• 第三方 · Gemini in SillyTavern（2026）：https://arcanumrpgs.com/blog/sillytavern-gemini/