ntthanh2603/gemini-web-to-api

解决的问题

通常，要以编程方式使用 Google Gemini 的模型，你需要官方 API 密钥和配额。这个项目通过将 Gemini 的网页界面（你在浏览器中使用的聊天机器人）转换为本地 API 服务器来消除这一障碍。你只需将浏览器 cookie 粘贴到配置中，服务器就会处理身份验证和会话维护，这样你就可以在没有 API 密钥的情况下从自己的代码中调用 Gemini。

工作原理

服务器在本地运行（默认端口 4981），并使用你的浏览器已经发出的 batchexecute 请求与 Gemini 的网页后端通信。它从你登录的浏览器会话中提取 cookie 头，并用它来验证请求。服务器会定期轮换 cookie 以保持会话活跃并避免被阻止。它提供三种 API 风格：OpenAI 兼容（/openai/v1）、Claude 兼容（/claude）和 Gemini 原生（/gemini）。模型名称会从你的账户的 Gemini Web 模型注册表中动态发现，因此新添加的模型无需更改代码即可使用。它还通过相同的接口支持图像生成、图像输入、视频生成、Canvas 文档和音乐生成。

适用人群

适用于希望在没有 API 密钥的情况下在 Gemini 最新模型上构建应用程序的开发者，或希望本地测试 Gemini 集成的开发者。它对于使用基于 cookie 的身份验证进行原型设计也很有用。由于它提供多种 API 格式，因此可以作为现有 OpenAI、Claude 或 Gemini SDK 的直接替代品。

亮点

• 无需 API 密钥——只需浏览器 cookie
• 从单个服务器支持 OpenAI、Claude 和 Gemini API 协议
• 从 Gemini Web 的注册表动态发现模型（例如 gemini-auto、gemini-3.6-flash）
• 超越聊天：图像生成、图像输入、视频生成、Canvas 文件和音乐生成
• 使用 Go 和 Fiber 构建，性能高，支持 Docker 和 Docker Compose
• 包括速率限制、cookie 轮换和会话管理，以避免被阻止
• 通过 Scalar UI 在 /docs 提供交互式 API 文档