su-kaka/agy2api

解决的问题

该项目解决了将 Google 的 Antigravity 平台（提供对 Claude 和 Gemini 等模型的访问）与标准 API 客户端工具一起使用的问题。许多开发人员熟悉 OpenAI、Gemini 和 Claude API，但 Antigravity 本身不提供这些格式。AGY2API 将 Antigravity 转换为这三种 API 风格的即插即用替代品，因此您可以使用现有代码和客户端，而无需重写它们。

工作原理

AGY2API 作为本地服务器运行（默认端口 7861），接受 OpenAI、Gemini 或 Claude 格式的请求，将其转换为 Antigravity API 调用，并将响应流式返回。它管理多个 Google OAuth 凭据，自动轮换它们以实现负载均衡。系统监控 HTTP 429（速率限制）等错误，并临时禁用有问题的凭据。它还提供自动模型名称映射、敏感词过滤、请求日志记录和 IP 白名单等功能。Web 控制面板允许您使用 Antigravity 进行身份验证、上传或导出凭据以及配置设置。凭据默认存储在 SQLite 中，如果配置了 PostgreSQL，则存储在 PostgreSQL 中。

适用人群

希望通过熟悉的 API 接口利用 Antigravity 模型选择（Claude、Gemini 等）的开发人员和用户。它适合在 Windows、Linux、macOS、Termux 或 Docker 上运行自托管服务的用户，尤其是那些希望使用支持多凭据轮换和管理的统一网关的用户。

亮点

• 多格式端点 – 在一个服务中支持 OpenAI /v1/chat/completions、Gemini 原生 generateContent 和 Claude /v1/messages。
• 智能凭据池 – 自动轮换 Google OAuth 凭据，处理速率限制冷却，并禁用失败的凭据。
• 流式传输和防截断 – 实时 SSE 流式传输，外加可选的“防截断”模式（在模型名称前加上 抗截断-），使用合成工具调用避免响应被截断。
• Web 管理控制台 – 基于 React 的 UI，用于 OAuth 登录、凭据上传/导出、批量操作和系统配置。
• 灵活部署 – 为 Termux、Windows、Linux、macOS 和 Docker 提供一键安装程序，并可选配 PostgreSQL 和 Redis 以支持多实例设置。