Gemi2Api-Server

HanaokaYuzu / Gemini-API 的服务端简单实现

原始界面	管理面板

在线体验

平台	地址	面板密码
Render	gemi2api-server-1ol5.onrender.com/admin/	`Gemi2Api-Server`（demo 专用，请勿用于生产）
HuggingFace	zhiyu1998-gemi2api-server.hf.space/admin/	`Gemi2Api-Server`（demo 专用，请勿用于生产）

[!NOTE] 以上体验地址未配置 Gemini Cookie，仅展示管理面板界面。如需完整功能请自行部署。

快捷部署

Render

HuggingFace

直接运行

填入 SECURE_1PSID 和 SECURE_1PSIDTS（登录 Gemini 在浏览器开发工具中查找 Cookie），有必要的话可以填写 API_KEY

SECURE_1PSID = "COOKIE VALUE HERE"
SECURE_1PSIDTS = "COOKIE VALUE HERE"
API_KEY= "API_KEY VALUE HERE"
TEMPORARY_CHAT = "false" # 使用临时对话模式，此模式会禁用部分功能如思考、图片生成等，默认关闭。
AUTO_DELETE_CHAT = "true" # 生成结束后自动从web端删除对话记录，默认开启。TEMPORARY_CHAT为true时，此项无效。
PUBLIC_BASE_URL = "https://your-domain.com" # 外部URL，用于生成图片代理链接，不填则会使用内部地址。使用反向代理时必填，否则可能导致图片无法访问。
CUSTOM_MODELS_FILE = "custom_models.yaml" # 可选。用于覆写/新增 Gemini 模型定义，支持 YAML/JSON。

custom_models.yaml 示例：

models:
  - model_name: "gemini-3.5-flash"
    model_header:
      x-goog-ext-525001261-jspb: '[1,null,null,null,"56fdd199312815e2",null,null,0,[4,5,6,8],null,null,2,null,null,1,1,"09D681E7-26F2-4A94-A465-38386B7AB93B"]'
  - model_name: "gemini-3.5-flash-extended"
    model_header:
      x-goog-ext-525001261-jspb: '[1,null,null,null,"56fdd199312815e2",null,null,0,[4,5,6,8],null,null,2,null,null,1,2,"B827D4F4-D475-4ECA-9111-5C1296A38681"]'
  - model_name: "gemini-3.1-flash-lite"
    model_header:
      x-goog-ext-525001261-jspb: '[1,null,null,null,"8c46e95b1a07cecc",null,null,0,[4,5,6,8],null,null,2,null,null,6,1,"09D681E7-26F2-4A94-A465-38386B7AB93B"]'
  - model_name: "gemini-3.1-pro"
    model_header:
      x-goog-ext-525001261-jspb: '[1,null,null,null,"e6fa609c3fa255c0",null,null,0,[4,5,6,8],null,null,2,null,null,3,1,"09D681E7-26F2-4A94-A465-38386B7AB93B"]'
  - model_name: "gemini-deep-research"
    model_header:
      x-goog-ext-525001261-jspb: '[1,null,null,null,"cd472a54d2abba7e"]'

main.py 会按 CUSTOM_MODELS_FILE 中的 model_header 原样透传；如果你需要 x-goog-ext-73010989-jspb 或 x-goog-ext-73010990-jspb，请在 YAML 里显式写出来。 x-goog-ext-525005358-jspb 不需要手填，运行时会按每次请求自动生成。 CUSTOM_MODELS_FILE 会在每次请求/读取模型列表时重新加载，修改文件内容后无需重启服务。

安装依赖

uv init
uv add fastapi uvicorn gemini-webapi httpx h2

[!NOTE] 如果存在 pyproject.toml 那么就使用下面的命令：

uv sync

或者 pip 也可以：

pip install fastapi uvicorn gemini-webapi httpx h2

激活环境

source venv/bin/activate

启动

uvicorn main:app --reload --host 127.0.0.1 --port 7860

[!WARNING] tips: .env.example 中默认设置了 API_KEY=Gemi2Api-Server，复制到 .env 后即可登录管理面板。正式部署前请务必更换为强密码。

使用 Docker 运行（推荐）

快速开始

克隆本项目

git clone https://github.com/zhiyu1998/Gemi2Api-Server.git

创建 .env 文件并填入你的 Gemini Cookie 凭据:

cp .env.example .env
# 用编辑器打开 .env 文件，填入你的 Cookie 值

启动服务:
```
docker-compose up -d
```
服务将在 http://127.0.0.1:7860 上运行

其他 Docker 命令

# 查看日志
docker-compose logs

# 重启服务
docker-compose restart

# 停止服务
docker-compose down

# 重新构建并启动
docker-compose up -d --build

API 端点

GET /: 服务状态检查
GET /v1/models: 获取可用模型列表
POST /v1/chat/completions: 与模型聊天 (类似 OpenAI 接口)
GET /gemini-proxy/image: 图片代理接口（有生成图片需求时，需要保证此端点可直接访问，如果使用反向代理则需要填写 PUBLIC_BASE_URL 环境变量）
GET /admin: 管理面板

管理面板

访问 /admin 进入管理面板，支持以下功能：

查看服务状态和 Gemini 连接状态
配置 Gemini Cookie（无需重启）
修改 API_KEY、限流等参数
查看实时日志
在线测试聊天

[!NOTE] 未设置 API_KEY 时管理面板不可用。密码通过 .env 文件中的 API_KEY 配置，.env.example 提供了默认值 Gemi2Api-Server，正式部署前请务必更换。

常见问题

服务器报 500 问题解决方案

500 的问题一般是 IP 不太行或者请求太频繁（后者等待一段时间或者重新新建一个隐身标签登录一下重新给 Secure_1PSID 和 Secure_1PSIDTS 即可），见 issue：

解决步骤：

使用隐身标签访问 Google Gemini 并登录
打开浏览器开发工具 (F12)
切换到 "Application" 或 "应用程序" 标签
在左侧找到 "Cookies" > "gemini.google.com"
复制 __Secure-1PSID 和 __Secure-1PSIDTS 的值
更新 .env 文件
重新构建并启动: docker-compose up -d --build

致谢

图片去水印算法基于 journey-ad/gemini-watermark-remover 以及 allenk/GeminiWatermarkTool 实现，并直接使用了其中的两张 png 图片。

贡献

同时感谢以下开发者对 Gemi2Api-Server 作出的贡献：