Cloudflare AI Gateway 接入 Google Gemini 指南

Cloudflare AI Gateway 接入 Google Gemini 教程

核心思路

Cloudflare AI Gateway 提供了 OpenAI 兼容模式，能将聊天客户端的请求转换为 Google Gemini 可识别的语言，并将回复返回，使客户端以为在与 OpenAI 交互。

准备工作

1. Google AI Studio API Key
   • 地址：https://aistudio.google.com/app/apikey
   • 登录后创建 API 密钥，复制以 AIzaSy... 开头的 Key。
2. Cloudflare 账号
   • 注册免费账号：https://dash.cloudflare.com/sign-up
3. 支持 OpenAI API 的 AI 聊天客户端
   • 如 LobeChat、ChatGPT-Next-Web 等，需支持自定义 API URL 或 Base URL。

第一步：创建 Cloudflare AI Gateway

1. 登录 Cloudflare Dashboard。
2. 左侧导航栏选择 "AI" > "AI Gateway"。
3. 点击 "Create Gateway"。
4. 输入网关名称（如 my-gemini-gateway），点击 "Create"。
5. 进入网关详情，点击右上角 API 按钮，记录 Account ID 和 Gateway Name。
6. 复制 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