Anti-API

The fastest and best local API proxy service! Convert Antigravity's top AI models to OpenAI/Anthropic compatible API

中文说明 | Features | Quick Start | Architecture

Disclaimer: This project is based on reverse engineering of Antigravity. Future compatibility is not guaranteed. For long-term use, avoid updating Antigravity.

What's New (v2.4.0)

✅ Streaming Optimization - Improved stream reading to reduce unexpected interruptions
✅ Docker Support - Complete Docker deployment with one-click start scripts
✅ Log Panel - Real-time log viewer in the dashboard
✅ UI Layout - Optimized quota card layout and privacy masking
✅ One-Click Scripts - start.command (macOS) / start.bat (Windows) for native launch
✅ Docker Scripts - dstart.command / dstart.bat for Docker launch

Features

🎯 Flow + Account Routing - Custom flows for non-official models, account chains for official models
🌐 Remote Access - ngrok/cloudflared/localtunnel with one-click setup
📊 Full Dashboard - Quota monitoring, routing config, settings panel
🔄 Auto-Rotation - Seamless account switching on 429 errors
⚡ Dual Format - OpenAI and Anthropic API compatible
🛠️ Tool Calling - Function calling for Claude Code and CLI tools

Free Gemini Pro Access

Two free methods to get one year of Gemini Pro:

Method 1: Telegram Bot (Quick and stable, one-time free) https://t.me/sheeridverifier_bot

Method 2: @pastking's Public Service (Unlimited, requires learning) https://batch.1key.me

Quick Start

Linux

# Install dependencies
bun install

# Start server (default port: 8964)
bun run src/main.ts start

Windows

Double-click anti-api-start.bat to launch.

macOS

Double-click anti-api-start.command to launch.

Docker

Build:

docker build -t anti-api .

Run:

docker run --rm -it \\
  -p 8964:8964 \\
  -p 51121:51121 \\
  -e ANTI_API_DATA_DIR=/app/data \\
  -e ANTI_API_NO_OPEN=1 \\
  -e ANTI_API_OAUTH_NO_OPEN=1 \\
  -v $HOME/.anti-api:/app/data \\
  anti-api

Compose:

docker compose up --build

Developer override (no rebuild, use local src/ and public/):

docker compose up -d --no-build

Notes:

OAuth callback uses port 51121. Make sure it is mapped.
If running on a remote host, set ANTI_API_OAUTH_REDIRECT_URL to a public URL like http://YOUR_HOST:51121/oauth-callback.
The bind mount reuses your local ~/.anti-api data so Docker shares the same accounts and routing config.
Set ANTI_API_NO_OPEN=1 to avoid trying to open the browser inside a container.
If Docker Hub is unstable, the default base image uses GHCR. You can override with BUN_IMAGE=oven/bun:1.1.38.
ngrok will auto-download inside the container if missing (Linux only).

Development

Formatting: follow .editorconfig (4-space indent, LF).
Tests: bun test
Contributing: see docs/CONTRIBUTING.md

Claude Code Configuration

Add to ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8964",
    "ANTHROPIC_AUTH_TOKEN": "any-value"
  }
}

Remote Access

Access the tunnel control panel at http://localhost:8964/remote-panel

Supported tunnels:

ngrok - Requires authtoken from ngrok.com
cloudflared - Cloudflare Tunnel, no account required, high network requirements
localtunnel - Open source, no account required, less stable

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      Anti-API (Port 8964)                   │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │  Dashboard   │  │   Routing    │  │   Settings   │      │
│  │   /quota     │  │   /routing   │  │   /settings  │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
│                                                              │
│  ┌──────────────────────────────────────────────────────┐  │
│  │              Smart Routing System                     │  │
│  │  • Flow Routing (custom model IDs)                    │  │
│  │  • Account Routing (official model IDs)               │  │
│  │  • Auto-rotation on 429 errors                        │  │
│  │  • Multi-provider support                             │  │
│  └──────────────────────────────────────────────────────┘  │
│                           ▼                                  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Antigravity  │  │    Codex     │  │   Copilot    │      │
│  │   Provider   │  │   Provider   │  │   Provider   │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
                           ▼
              ┌──────────────────────────┐
              │   Upstream Cloud APIs    │
              │ (Google, OpenAI, GitHub) │
              └──────────────────────────┘

Smart Routing System (Beta)

⚠️ Beta Feature: Routing is experimental. Configuration may change in future versions.

The routing system is split into two modes:

Flow Routing: Custom model IDs (e.g. route:fast) use your flow entries.
Account Routing: Official model IDs (e.g. claude-sonnet-4-5) use per-model account chains.

This enables fine-grained control over model-to-account mapping, allowing you to:

Load Balance: Distribute requests across multiple accounts
Model Specialization: Route specific models to dedicated accounts
Provider Mixing: Combine Antigravity, Codex, and Copilot in custom flows
Fallback Chains: Automatic failover when primary accounts hit rate limits

How It Works

Request
  ├─ Official model → Account Routing → Account chain → Provider → Upstream API
  └─ Custom model/route:flow → Flow Routing → Flow entries → Provider → Upstream API

No match → 400 error

Configuration

Access Panel: http://localhost:8964/routing
Flow Routing: Create a flow (e.g., "fast", "opus"), add Provider → Account → Model entries
Account Routing: Choose an official model, set account order, optionally enable Smart Switch
Use Flow: Set model to route:<flow-name> or the flow name directly
Use Official Model: Request the official model ID directly (e.g., claude-sonnet-4-5)

Example Request:

{
  "model": "route:fast",
  "messages": [{"role": "user", "content": "Hello"}]
}

Flow Priority: Entries are tried in order. If an account hits 429, the next entry is used. Account Routing: If Smart Switch is on and no explicit entries exist, it expands to all supporting accounts in creation order.

Remote Access

Expose your local Anti-API to the internet for cross-device access. Useful for:

Mobile Development: Test AI integrations on iOS/Android
Team Sharing: Share your quota with teammates
External Tools: Connect AI tools that require public URLs

Supported Tunnels

Tunnel	Account Required	Stability	Speed
ngrok	✅ Yes (free tier)	⭐⭐⭐ Best	Fast
cloudflared	❌ No	⭐⭐ Good	Medium
localtunnel	❌ No	⭐ Fair	Slow

Setup

Access Panel: http://localhost:8964/remote-panel
Configure (ngrok only): Enter your authtoken from ngrok.com
Start Tunnel: Click Start, wait for public URL
Use Remote URL: Replace localhost:8964 with the tunnel URL

Security Note: Anyone with your tunnel URL can access your API. Keep it private.

Settings Panel

Configure application behavior at http://localhost:8964/settings:

Auto-open Dashboard: Open quota panel on startup
Auto-start ngrok: Start tunnel automatically
Model Preferences: Set default models for background tasks

Supported Models

Antigravity

Model ID	Description
`claude-sonnet-4-5`	Fast, balanced
`claude-sonnet-4-5-thinking`	Extended reasoning
`claude-opus-4-5-thinking`	Most capable
`gemini-3-flash`	Fastest responses
`gemini-3-pro-high`	High quality
`gemini-3-pro-low`	Cost-effective
`gpt-oss-120b`	Open source

GitHub Copilot

Model ID	Description
`claude-opus-4-5-thinking`	Opus via Copilot
`claude-sonnet-4-5`	Sonnet via Copilot
`gpt-4o`	GPT-4o
`gpt-4o-mini`	GPT-4o Mini
`gpt-4.1`	GPT-4.1
`gpt-4.1-mini`	GPT-4.1 Mini

ChatGPT Codex

Model ID	Description
`gpt-5.2-max-high`	5.2 Max (High)
`gpt-5.2-max`	5.2 Max
`gpt-5.2`	5.2
`gpt-5.2-codex`	5.2 Codex
`gpt-5.1`	5.1
`gpt-5.1-codex`	5.1 Codex
`gpt-5`	5

API Endpoints

Endpoint	Description
`POST /v1/chat/completions`	OpenAI Chat API
`POST /v1/messages`	Anthropic Messages API
`GET /v1/models`	List models
`GET /quota`	Quota dashboard
`GET /routing`	Routing config
`GET /settings`	Settings panel
`GET /remote-panel`	Tunnel control
`GET /health`	Health check

Code Quality & Testing

✅ Unit Tests - Core logic covered with automated tests
✅ Formatting Rules - .editorconfig keeps diffs consistent
✅ Input Validation - Request validation for security
✅ Response Time Logging - Performance monitoring
✅ Centralized Constants - No magic numbers
✅ Comprehensive Docs - API reference, architecture, troubleshooting

See docs/ folder for detailed documentation.

License

MIT

中文说明

致力于成为最快最好用的API本地代理服务！将 Antigravity 内模型配额转换为 OpenAI/Anthropic 兼容的 API

免责声明：本项目基于 Antigravity 逆向开发，未来版本兼容性未知，长久使用请尽可能避免更新Antigravity。

更新内容 (v2.4.0)

✅ 流式优化 - 优化流式读取，减少意外中断
✅ Docker 支持 - 完善 Docker 部署，提供一键启动脚本
✅ 日志面板 - 面板内实时查看服务器日志
✅ UI 布局优化 - 配额卡片布局优化，隐私遮罩改进
✅ 一键启动脚本 - start.command (macOS) / start.bat (Windows) 本地启动
✅ Docker 脚本 - dstart.command / dstart.bat Docker 启动

特性

🎯 Flow + Account 路由 - 自定义流控制非官方模型，官方模型使用账号链
🌐 远程访问 - ngrok/cloudflared/localtunnel 一键设置
📊 完整面板 - 配额监控、路由配置、设置面板
🔄 自动轮换 - 429 错误时无缝切换账号
⚡ 双格式支持 - OpenAI 和 Anthropic API 兼容
🛠️ 工具调用 - 支持 function calling，兼容 Claude Code

开发规范

格式规范：遵循 .editorconfig（4 空格缩进、LF 行尾）
测试：运行 bun test
贡献指南：参考 docs/CONTRIBUTING.md

系统架构

┌─────────────────────────────────────────────────────────────┐
│                      Anti-API (端口 8964)                   │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │   配额面板   │  │   路由配置   │  │   设置面板   │      │
│  │   /quota     │  │   /routing   │  │   /settings  │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
│                                                              │
│  ┌──────────────────────────────────────────────────────┐  │
│  │              智能路由系统                             │  │
│  │  • Flow 路由（自定义模型 ID）                         │  │
│  │  • Account 路由（官方模型 ID）                        │  │
│  │  • 429 错误自动轮换                                   │  │
│  │  • 多提供商支持                                       │  │
│  └──────────────────────────────────────────────────────┘  │
│                           ▼                                  │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ Antigravity  │  │    Codex     │  │   Copilot    │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘

智能路由系统 (Beta)

⚠️ 测试功能：路由系统为实验性功能，配置格式可能在未来版本中变更。

路由系统拆分为两种模式：

Flow 路由：自定义模型 ID（如 route:fast）使用流配置
Account 路由：官方模型 ID（如 claude-sonnet-4-5）使用账号链

由此实现模型到账号的精细控制：

负载均衡 - 将请求分发到多个账号
模型专用 - 指定模型使用专用账号
混合提供商 - 组合 Antigravity、Codex、Copilot
自动降级 - 账号触发 429 时自动切换下一个

工作流程

请求
  ├─ 官方模型 → Account 路由 → 账号链 → 提供商 → 上游 API
  └─ 自定义模型/route:flow → Flow 路由 → 流条目 → 提供商 → 上游 API

无匹配 → 400 错误

配置方法

访问面板: http://localhost:8964/routing
Flow 路由: 创建流（如 "fast", "opus"），添加提供商 → 账号 → 模型条目
Account 路由: 选择官方模型，配置账号顺序，按需开启 Smart Switch
使用流: 设置 "model": "route:<流名称>" 或直接使用流名
使用官方模型: 直接请求官方模型 ID（如 claude-sonnet-4-5）

Flow 顺序：按配置顺序尝试，429 时切换下一个。 Account 路由：Smart Switch 开启且未配置条目时，按账号创建顺序自动展开。

远程访问

将本地 Anti-API 暴露到公网，支持跨设备访问：

移动开发 - iOS/Android 测试 AI 集成
团队共享 - 与队友共享配额
外部工具 - 连接需要公网 URL 的 AI 工具

隧道对比

隧道	需要账号	稳定性	速度
ngrok	✅ 是	⭐⭐⭐ 最佳	快
cloudflared	❌ 否	⭐⭐ 良好	中
localtunnel	❌ 否	⭐ 一般	慢

设置方法

访问面板: http://localhost:8964/remote-panel
配置 (ngrok): 输入 ngrok.com 的 authtoken
启动隧道: 点击启动，等待公网 URL
使用远程 URL: 用隧道 URL 替换 localhost:8964

安全提示: 任何人拥有隧道 URL 即可访问您的 API，请妥善保管。

设置面板

访问 http://localhost:8964/settings 配置：

自动打开面板: 启动时打开配额面板
自动启动 ngrok: 自动启动隧道
模型偏好: 设置后台任务默认模型

支持的模型

Antigravity

模型 ID	说明
`claude-sonnet-4-5`	快速均衡
`claude-sonnet-4-5-thinking`	扩展推理
`claude-opus-4-5-thinking`	最强能力
`gemini-3-flash`	最快响应
`gemini-3-pro-high`	高质量

GitHub Copilot

模型 ID	说明
`claude-opus-4-5-thinking`	Opus
`claude-sonnet-4-5`	Sonnet
`gpt-4o`	GPT-4o
`gpt-4o-mini`	GPT-4o Mini
`gpt-4.1`	GPT-4.1

ChatGPT Codex

模型 ID	说明
`gpt-5.2-max-high`	5.2 Max (High)
`gpt-5.2-max`	5.2 Max
`gpt-5.2`	5.2
`gpt-5.1`	5.1
`gpt-5`	5

API 端点

端点	说明
`POST /v1/chat/completions`	OpenAI Chat API
`POST /v1/messages`	Anthropic Messages API
`GET /quota`	配额面板
`GET /routing`	路由配置
`GET /settings`	设置面板
`GET /remote-panel`	隧道控制

代码质量

✅ 单元测试 - 核心逻辑完整测试
✅ 输入验证 - 请求验证保障安全
✅ 响应时间日志 - 性能监控
✅ 常量集中管理 - 无魔法数字

详细文档见 docs/ 文件夹。

开源协议

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
docs		docs
public		public
rust-proxy		rust-proxy
src		src
test		test
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
Dockerfile		Dockerfile
LICENSE		LICENSE
MULTI-ACCOUNT.md		MULTI-ACCOUNT.md
README.md		README.md
add-account.ts		add-account.ts
anti-api-v2.2.0.zip		anti-api-v2.2.0.zip
bun.lock		bun.lock
docker-compose.override.yml		docker-compose.override.yml
docker-compose.yml		docker-compose.yml
docker-function.fish		docker-function.fish
dstart.bat		dstart.bat
dstart.command		dstart.command
package.json		package.json
start.bat		start.bat
start.command		start.command
tsconfig.json		tsconfig.json

License

weaming/anti-api

Folders and files

Latest commit

History

Repository files navigation

Anti-API

What's New (v2.4.0)

Features

Free Gemini Pro Access

Quick Start

Linux

Windows

macOS

Docker

Development

Claude Code Configuration

Remote Access

Architecture

Smart Routing System (Beta)

How It Works

Configuration

Remote Access

Supported Tunnels

Setup

Settings Panel

Supported Models

Antigravity

GitHub Copilot

ChatGPT Codex

API Endpoints

Code Quality & Testing

License

中文说明

更新内容 (v2.4.0)

特性

开发规范

系统架构

智能路由系统 (Beta)

工作流程

配置方法

远程访问

隧道对比

设置方法

设置面板

支持的模型

Antigravity

GitHub Copilot

ChatGPT Codex

API 端点

代码质量

开源协议

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages