Gemini 官方支持的 OpenAI 兼容格式

GPT-Load 现已支持 Google Gemini 的官方 OpenAI 兼容格式，让您能够使用标准的 OpenAI SDK 和工具来访问 Gemini 模型的强大功能。

注意：这并不是格式转换，只是对Gemini官方的OpenAI兼容格式进行透明代理。详情请参考官方文档：https://ai.google.dev/gemini-api/docs/openai

GPT-Load 中的配置

步骤一：创建 Gemini 分组

分组配置

  • • 分组名称：gemini（建议使用此名称）
  • • 渠道类型：选择 “gemini” 类型
  • • 上游地址：https://generativelanguage.googleapis.com
  • • API 密钥：添加您的 Gemini API Key

重要说明

  • • 使用官方 Google 的 generativelanguage.googleapis.com 端点
  • • 确保 API 密钥有效且有足够的配额
  • • 分组创建后会自动兼容 OpenAI 兼容格式
  • • 支持负载均衡和故障转移

步骤二：获取代理端点

代理端点格式：GPT-Load 会为 Gemini 分组生成专用的 OpenAI 兼容端点

完整调用路径

http://localhost:3001/proxy/gemini/v1beta/openai/chat/completions

客户端调用示例

Cherry Studio 配置

推荐使用：Cherry Studio 是一个优秀的 AI 客户端，完美支持 Gemini OpenAI 兼容格式

配置步骤

  1. 1. 打开 Cherry Studio
  2. 2. 创建新的渠道，提供商类型选择OpenAI
  3. 3. 设置基础URL为代理端点
  4. 4. 输入代理密钥
  5. 5. 开始使用 Gemini 模型

配置参数

提供商类型：OpenAI
基础URL：

http://localhost:3001/proxy/gemini/v1beta/openai/

（必须以 / 结尾）

API Key：your-proxy-key

cURL 直接调用

curl -X POST "http://localhost:3001/proxy/gemini/v1beta/openai/chat/completions" \
  -H "Authorization: Bearer your-proxy-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {
        "role": "user",
        "content": "hi"
      }
    ]
  }'

注意事项

  • • 确保 GPT-Load 版本最新以支持 Gemini OpenAI 兼容格式
  • • Cherry Studio 基础URL必须以斜杠（/）结尾，否则可能导致调用失败
  • • Gemini API Key 需要有足够的配额和正确的权限