Cloudflare AI Gateway 接入 Google Gemini 教程
核心思路
Cloudflare AI Gateway 提供了 OpenAI 兼容模式,能将聊天客户端的请求转换为 Google Gemini 可识别的语言,并将回复返回,使客户端以为在与 OpenAI 交互。
准备工作
- Google AI Studio API Key
- 地址:https://aistudio.google.com/app/apikey
- 登录后创建 API 密钥,复制以
AIzaSy...开头的 Key。
- Cloudflare 账号
- 支持 OpenAI API 的 AI 聊天客户端
- 如 LobeChat、ChatGPT-Next-Web 等,需支持自定义 API URL 或 Base URL。
第一步:创建 Cloudflare AI Gateway
- 登录 Cloudflare Dashboard。
- 左侧导航栏选择 "AI" > "AI Gateway"。
- 点击 "Create Gateway"。
- 输入网关名称(如
my-gemini-gateway),点击 "Create"。 - 进入网关详情,点击右上角 API 按钮,记录 Account ID 和 Gateway Name。
- 复制 API Endpoint URL,例如:
https://gateway.ai.cloudflare.com/v1/{AccountID}/{GatewayName}/google-ai-studio。注意最终 URL 通常不包含/google-ai-studio后缀。

Cloudflare 支持 OpenAI 兼容端点,将上述信息填入。
第二步:构建最终 API URL
Cloudflare AI Gateway 使用 /compat 模式兼容 OpenAI API 格式。
最终提供给客户端的 Base URL 为:https://gateway.ai.cloudflare.com/v1/{AccountID}/{GatewayName}/compat
注意:
- 不要包含
/google-ai-studio。 - 不要添加
/chat/completions,客户端会自动追加。
配置示例:Cherry Studio



