silasxbt/anti-api

Anti‑API – 用于 LLM 提供商的本地兼容性与路由代理

是什么 – Anti‑API 是一个自托管服务，位于您的代码（或任何 OpenAI/Anthropic 兼容客户端）与多个大语言模型提供商之间。它将标准的 OpenAI/Anthropic 请求格式转换为六个支持后端的原生 API（OpenAI 风格的 Antigravity、OpenAI Codex、GitHub Copilot、Zed 托管模型、Amazon Kiro 和 xAI Grok），并根据可配置策略路由每个请求。

为何重要 – 许多开发者在其应用程序中使用 OpenAI API 格式，但他们可能拥有多个付费账户或替代提供商。Anti‑API 让您能够：

• 将这些账户统一到单个端点（http://localhost:8964）之后。
• 平衡负载、遵守配额限制，并在提供方返回 429/404 错误时自动切换到另一个账户。
• 暴露一个公开的、令牌保护的推理网关（端口 8966），供远程客户端使用，而不会泄露凭证或管理 UI。
• 在所有提供方之间使用相同的客户端代码处理纯文本、多模态（图像）和工具调用请求。

主要功能（如 README 所述）

• 六个提供方 – Antigravity、ChatGPT Codex、GitHub Copilot、Zed 托管模型、Amazon Kiro、xAI Grok。
• 双重 API 兼容性 – 接受 OpenAI 风格和 Anthropic 风格的请求体。
• 智能路由 – 两种路由模式：
  • 流路由 – 自定义模型标识符映射到用户定义的“流”。
  • 账户路由 – 提供方原生模型 ID 被分派到特定账户，配额或错误条件下启用粘性轮询。
• 多模态安全 – 在转发到目标提供方之前，验证并转换图像 URL 或 base-64 图像块。
• OAuth 与 PKCE 处理 – 内置 Copilot 的设备码流程，以及 Antigravity/Codex 的安全 PKCE 流程，支持回环回调和可选的不安全 TLS 覆盖，适用于受限网络。
• 仪表板 – 本地 Web UI（仅限回环）显示配额使用情况、路由配置和账户诊断信息。
• 远程隧道 – 一键式 ngrok/cloudflared/localtunnel 设置，用于公开仅推理监听器。
• Docker 与包管理器支持 – 提供预构建的多架构 Docker 镜像、Homebrew、WinGet 和便携式 Windows 套件。
• 安全边界 – 管理 API 和仪表板绑定到 127.0.0.1；公开推理监听器需要一个秘密令牌（ANTI_API_PUBLIC_TOKEN）。凭证文件本地存储在 ~/.anti-api，从不记录日志。

快速开始（摘要）

• Linux/macOS – bun install && bun run src/main.ts start（默认端口 8964）。
• Windows – 双击 start.bat（或运行安装的 anti-api 命令）。
• Docker – 拉取 ghcr.io/silasxbt/anti-api:latest 并使用控制平面令牌运行，例如：

export ANTI_API_CONTROL_TOKEN=$(openssl rand -hex 32)

docker run -d \
  -p 127.0.0.1:8964:8964 \
  -e ANTI_API_CONTAINER_CONTROL_PLANE=1 \
  -e ANTI_API_CONTROL_TOKEN=$ANTI_API_CONTROL_TOKEN \
  -v anti-api-data:/app/data \
  ghcr.io/silasxbt/anti-api:latest

• 打开 http://localhost:8964/quota?control_token=<your-token> 以启动所需提供方的 OAuth 登录，然后将您的客户端指向 http://localhost:8964。

架构快照

Anti‑API（端口 8964） ──► 仪表板 / 设置 / 路由 UI（仅限回环）
                     │
                     ├─► 智能路由引擎
                     │    • 流路由（自定义 ID）
                     │    • 账户路由（提供方原生 ID）
                     │    • 冷却感知故障转移与粘性轮询
                     │
                     └─► 提供方适配器
                          ├─ Antigravity（OpenAI 风格）
                          ├─ Codex
                          ├─ GitHub Copilot（设备码流程）
                          ├─ Zed 托管模型
                          ├─ Amazon Kiro
                          └─ xAI Grok

上游调用发送到各自的云 API（Google、OpenAI、GitHub、Zed 等）。端口 8966 上的独立公开监听器在设置 ANTI_API_PUBLIC_TOKEN 时提供仅推理请求服务。

谁可能使用它

• 拥有多个付费 LLM 账户并希望拥有单一一致端点的团队。
• 构建开源工具的开发者，期望 OpenAI/Anthropic API 格式但希望在本地使用替代后端。
• 需要公开 LLM 网关但不希望暴露凭证文件的自托管服务。

限制 / 警告

• 该项目为 非官方；某些提供方可能更改其私有端点，导致中断。
• 远程推理受令牌保护；在没有强令牌的情况下暴露公开监听器是不安全的。
• 某些提供方（如 Antigravity）需要定期刷新客户端版本；禁用此检查可能导致不兼容。
• 多模态转换仅限于每个下游提供方支持的图像格式。

---

• 上述所有信息均直接来自仓库的 README；未推断任何额外功能。*