一键同步 Gemini 登录态：gemini-web2api 配套浏览器扩展 gemini-cookie-sync-extension 深度解析

一键同步 Gemini 登录态gemini-web2api 配套浏览器扩展 gemini-cookie-sync-extension 深度解析【免费下载链接】gemini-web2apiConvert Google Gemini web into OpenAI-compatible API. Zero auth, cross-platform, single file.项目地址: https://gitcode.com/gh_mirrors/ge/gemini-web2apigemini-web2api能把 Google Gemini 网页端转换成 OpenAI 兼容 API零成本、跨平台、单文件部署。但如果你要用到gemini-3.1-pro等需要登录态的模型就得手动复制 Cookie、XSRF token既繁琐又容易出错。今天我们来深度解析项目配套的浏览器扩展gemini-cookie-sync-extension它能在浏览器里一键同步 Gemini 登录态自动导出gemini-auth.json让 API 服务 5 分钟内完成认证配置。为什么需要登录态同步匿名模式下 gemini-web2api 可以调用 Flash 系列模型但会遇到两个硬伤Pro 模型静默降级没有付费订阅账号的登录态时gemini-3.1-pro实际会被路由到 Flash 模型图片上传受限多模态图片输入依赖网页端的上传接口匿名失败时需要 Cookie传统做法是打开开发者工具 → Application → Cookies → 逐个复制SID、HSID、SAPISID等还要从页面源码里手动翻出 XSRF token。整个过程至少 10 分钟且xsrf_token过期后一切前功尽弃。而登录态请求需要四个关键要素缺一个都可能返回 400要素作用对应配置字段Google 会话 Cookie证明你是谁cookie_fileauth_user账号序号多账号浏览器中的目标账号auth_userSNlM0eXSRF token防跨站请求伪造校验xsrf_tokencfb2h版本标识Gemini 前端构建版本gemini_bl扩展能做什么一次导出四要素齐全这个扩展定义见 manifest.json基于 Manifest V3 开发只有四个文件popup.html弹出界面含 3 个按钮popup.js核心逻辑负责读取与导出README.txt快速说明SETUP.md完整安装与对接指南点击Export gemini-auth.json后扩展会读取当前已登录的 Gemini 会话把上述四要素一次性打包成本地 JSON 文件全程不经过网络传输——数据只落到你自己的磁盘上。一键安装步骤5 步装好扩展在 Chrome 地址栏打开chrome://extensions开启右上角开发者模式Developer mode点击加载已解压的扩展程序Load unpacked选择项目中的gemini-cookie-sync-extension/文件夹打开 Gemini 网页版登录后刷新页面这步很关键XSRF token 是刷新后才生成的3 步同步登录态到 gemini-web2api装好扩展后同步流程非常简单第 1 步检查会话。点击工具栏图标 →Inspect session确认状态显示XSRF / SNlM0e: present gemini_bl / cfb2h: present两项都是present才说明登录态完整。第 2 步导出文件。点击Export gemini-auth.json文件会保存到浏览器下载目录。然后把它拷到 gemini-web2api 项目目录并收紧权限完整命令可参考 SETUP.mdcp ~/Downloads/gemini-auth.json ./gemini-auth.json chmod 600 gemini-auth.json第 3 步更新配置。在 config.json可先复制config.example.json中填入对应字段{ cookie_file: /你的路径/gemini-auth.json, auth_user: 1, xsrf_token: AOOh0P..., gemini_bl: boq_assistant-bard-web-server_YYYYMMDD.xx_p0 }这些字段的默认值定义在 gemini_web2api/config.py 中。重启服务后发一条测试请求如果模型正常响应而非降级到 Flash就说明登录态同步成功了。原理速览它是怎么抓到 Token 的popup.js 的核心逻辑值得新手学一下Cookie 评分择优Google 域名下同名 Cookie 可能存在于多个作用域扩展按域名权重、路径、secure/httpOnly属性打分自动挑出最优的一条页面数据注入读取XSRF token 和版本标识藏在 Gemini 页面的WIZ_global_data全局变量里字段名为SNlM0e和cfb2h扩展通过脚本注入直接取出无需用户手动翻源码多账号识别自动从当前 URL 解析/u/序号/路径导出正确的auth_user避免多账号浏览器张冠李戴⚠️ 安全须知把它当密码保管gemini-auth.json包含你真实的 Google 登录会话等效于账号密码。请务必不要发送给任何人不要打印到日志严禁提交到 Git 仓库本地保存时保持chmod 600权限常见问题排查Q登录态请求返回 400错误包含xsrfXSRF token 已过期。刷新 Gemini 网页后重新 Inspect Export更新config.json中的xsrf_token即可。Q同步后 Pro 模型还是走 Flash免费账号的 Cookie 可以完成认证但没有 Gemini Advanced 付费订阅时会静默回退。需要付费订阅账号的登录态才能真正路由到 Pro。Q多账号浏览器中auth_user填什么看 Gemini 页面地址栏gemini.google.com/u/1/app就填1默认账号可以留空。总结gemini-cookie-sync-extension 把原本 10 分钟、高易错的手工 Cookie 流程压缩成 3 次点击是 gemini-web2api 解锁 Pro 模型和多模态能力的最佳搭档。完整对接流程详见 SETUP.md项目说明见 README_CN.md。【免费下载链接】gemini-web2apiConvert Google Gemini web into OpenAI-compatible API. Zero auth, cross-platform, single file.项目地址: https://gitcode.com/gh_mirrors/ge/gemini-web2api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考