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

末尾加斜杠防止客户端自动追加路径。推荐使用 v1 而非 v1beta。

第三步：配置 AI 聊天客户端

1. API URL / Base URL
   • 填入第二步构建的 URL。
2. API Key
   • 填入 Google AI Studio API Key。
3. 模型名称 (Model Name)
   • 格式：{提供商名称}/{模型名称}。
   • 例如：google-ai-studio/gemini-2.5-flash 或 google-ai-studio/gemini-2.5-pro。
   • 仅写模型名会报错。

模型命名规范

参考 Google AI Studio · Cloudflare AI Gateway docs 文档确认模型调用方式。

第四步：发送消息与流式输出处理

尝试发送消息。若遇到中文乱码或内容不完整：

• 原因：客户端对流式响应解析或编码处理差异。
• 解决方案：优先在客户端设置中关闭流式输出。这将一次性返回完整回复，避免乱码。

可在网关页面点击 "Logs" 标签检查请求状态。