这个项目能做什么

Gemini Web2API 是一个本地代理服务器,可将 OpenAI 风格的聊天完成请求转换为对 Google 内部 Gemini Web API 的调用。它不需要官方 API 密钥——而是使用从 Firefox 浏览器(通过 cookies.txt 扩展)导出的 cookies 以及从 Gemini 页面源码中提取的 xsrf 令牌。 该代理支持流式(SSE)和非流式响应、函数/工具调用,并兼容多种 Gemini 模型,包括 gemini-3.5-flash、gemini-pro 及自动选择变体。它通过指数退避算法自动处理速率限制,并包含 CORS 支持。 设置过程包括:克隆仓库、安装 Python 依赖项、导出 cookies、设置 xsrf 令牌,然后运行服务器。配置选项允许端口绑定、代理链、请求日志记录以及通过 API 密钥进行访问控制。该项目目前针对 Linux 设计,但可经少量修改适配 macOS 或 Windows。由于模拟了 OpenAI 的端点结构,它可与 OpenCode 等工具集成。 常见问题包括:cookies 过期、CAPTCHA 验证提示、IP 被封禁(尤其是数据中心 IP)以及构建版本过时(gemini_bl)。所有问题均在文档中提供了排查步骤。代码采用 MIT 许可证,欢迎为跨平台兼容性做出贡献。