Gemini API 使用指南：国内如何稳定调用 Google Gemini
Google Gemini 系列模型在长文本理解、多模态推理和代码生成等任务上表现非常亮眼，但国内开发者长期面临一个麻烦：`generativelanguage.googleapis.com` 直接不可达。免费 VPN 时断时续，自建代理又耗时费力。这篇文章会梳理几种可行方案，并给出一个零代理、可付费、立即可用的代码示例。
## 方案一览
1. **自建正向代理** 你可以用海外 VPS 搭建 Nginx 反代或 HTTP 代理，然后配置环境变量 `HTTPS_PROXY`。但 VPS 成本高，且 IP 一旦被 Google 标记，就需重新更换。
2. **Cloudflare Worker / Vercel 反代** 通过边缘计算把请求转发到 Gemni 官方端点。优点是免费额度够用，但 Worker 有每日请求次数和 CPU 时长限制，生产环境不够稳。
3. **第三方 API 中转服务** 直接使用已经完成线路优化的中转站，你拿到的就是一个标准的 OpenAI 兼容端点，域名可直接从国内访问，无需任何代理配置。这些中转站通常提供按量计费，充值就能用。
个人最常用的是第三种，下边以 TokenPocket API 中转站为例，演示如何 5 分钟跑通 Gemni 调用。
## 注册与获取密钥
打开 [TokenPocket 站点](https://tokenpocket.site)，使用邮箱注册并登录。新用户自动获得免费额度，可以先测试效果。
进入控制台，创建一个 API Key，复制备用。同时你会看到一个“接口地址”，通常为 `https://api.tokenpocket.site`，这个地址可以直接替换 OpenAI 库里的 `base_url`。
## 使用标准 OpenAI SDK 调用
Gemini 模型在中转站里一般命名为 `gemini-1.5-pro` 或 `gemini-2.0-flash`，我们可以直接用 OpenAI Python 库调用，无需安装 Google 的 `google-generativeai` 包。
先安装依赖：
```bash pip install openai ```
以下是完整的流式调用示例：
```python from openai import OpenAI
client = OpenAI( api_key="你的TokenPocket API Key", base_url="https://api.tokenpocket.site/v1" )
stream = client.chat.completions.create( model="gemini-2.0-flash", messages=[ {"role": "system", "content": "你是一个简洁的助手"}, {"role": "user", "content": "用100字解释什么是CORS"} ], stream=True )
for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="") ```
如果需要非流式，只需去掉 `stream=True`，然后直接打印 `response.choices[0].message.content` 即可。代码与调用任何 OpenAI 模型完全一致，切换模型仅需改 `model` 参数。
## 原理解读
中转站的后端做了几件事：接收你在境内发出的请求，通过专线或优化线路转发到 Google 官方端点，再把响应原样返回。因为传输路径全程没有经过公网代理，所以延迟比拖拽代理低很多。同时中转站屏蔽了 Google 的部分多余响应头，让你的客户端接收更干净。
你唯一要保证的就是本地网络能正常访问 `api.tokenpocket.site`——这对于国内网络来说是基本无障碍的。
## 费用与模型覆盖
TokenPocket 支持按量计费，用多少 token 就扣多少，账户里的余额以美元（USDT）计价。你可以在充值界面直接用 USDT 转账，几秒钟到账，避免了注册海外信用卡的麻烦。
目前可用的模型不只有 Gemini，还包括 DeepSeek、Qwen、Claude 等多个系列。每调一个新模型，只需在代码里改一行 `model` 参数，无需调整其他配置。对于想要同时对比多个模型回答质量的应用场景，这会非常方便。
## 小结
想要在国内稳定使用 Google Gemini，最优解往往不是自己折腾网络层，而是直接选择一个可靠的 API 中转站。你既不需要维护 VPS，也不用担心 IP 污染，只需拿到地址和 Key 就能立即开发，完全兼容 OpenAI 生态。
**推荐尝试 [TokenPocket](https://tokenpocket.site)，新用户注册即送免费额度，Gemini、DeepSeek、Qwen、Claude 等模型全支持，USDT 充值即用，按量计费零门槛。** 先用注册赠送的额度跑通 Demo，如果感觉稳定再小额充值，几乎可以零成本完成接入验证。