在構建 AI 應用程序或原型設計智能體(Agentic)工作流時,我們經常需要嘗試多種大型語言模型以找到最佳方案。然而,由於不同的供應商使用迥異的 API 結構和協議,在它們之間切換通常需要繁瑣的代碼重構,並需持續更新後端邏輯。
AIClient2API 正是為了解決這一挑戰而生。它充當智能代理層,模擬來自 Gemini CLI、Antigravity、Codex、Grok 和 Kiro 等平台的客戶端請求,並將其封裝為單一、標準化的 OpenAI 兼容 API 接口。除了協議統一外,它還提供了一個 Web UI 面板,用於實時監控每個節點的狀態。
核心功能
- 零成本模型切換:只需使用標準的 OpenAI SDK 格式編寫一次集成代碼,即可在不修改業務邏輯的情況下,動態切換後端供應商。
- 可視化管理控制台:內置 Web UI 面板,用於實時配置管理、健康狀態監控、通過內置 Playground 進行 API 測試,以及請求日誌審計。
技術架構與實現
該項目依賴於基於 Node.js 的 AI 優先模塊化架構,以處理協議轉換並保持高可用性:
plaintext1[ 您的應用程序 (Cherry-Studio / Cline / 自定義代碼) ] 2 │ (標準 OpenAI / Claude 請求) 3 ▼ 4 ┌─────────────────────────────┐ 5 │ AIClient2API 網關 │ 6 └──────────────┬──────────────┘ 7 │ 8 ┌─────────────┴─────────────┐ 9 ▼ ▼ 10 ┌──────────────┐ ┌──────────────┐ 11 │ 適配器層 │ │ 供應商池 │ 12 └───────┬──────┘ └───────┬──────┘ 13 │ │ (健康檢查 / 冷卻) 14 ▼ ▼ 15 ┌──────────────┐ ┌──────────────┐ 16 │ TLS Sidecar │ │ 故障轉移與 │ 17 │ (Go uTLS) │ │ 後備機制 │ 18 └───────┬──────┘ └───────┬──────┘ 19 │ │ 20 └─────────────┬─────────────┘ 21 ▼ 22 [ 後端:Gemini, Grok, Kiro...]
1. 策略與適配器模式
當請求到達網關時,系統會識別目標模型供應商,並通過特定的服務適配器進行路由。適配器將標準的 OpenAI 或 Claude 負載轉換為上游客戶端所需的精確結構(如 Gemini 的內部 CLI 結構或 Grok 的端點),並能無縫處理標準響應和流式(text/event-stream)響應。
2. 智能供應商池與後備鏈
為了確保生產級的可靠性,該代理管理著一個帳戶和端點池:
- 自動健康檢查與冷卻:系統執行週期性心跳檢測。如果節點故障或觸發 429 Too Many Requests 限制,它會被自動放入臨時冷卻隊列並繞過該節點。
- 跨類型後備:如果某個供應商類型的配額耗盡,網關可以將請求轉發至預先配置的後備鏈(例如,從 gemini-cli-oauth 自動切換至 gemini-antigravity),只要協議匹配即可。
3. TLS 指紋模擬 (TLS Sidecar)
部分上游服務會執行嚴格的網絡檢查,並阻斷不符合瀏覽器 TLS 指紋的請求。為了解決此問題,該項目引入了一個用 Go 編寫(使用 uTLS)的 TLS Sidecar 代理。它模擬標準 Chrome 的 TLS 握手並自動處理 HTTP/2 協商,從而防止 403 Forbidden 錯誤。
生態集成:Atlas Cloud 原生支持

在近期的更新中,AIClient2API 引入了對 Atlas Cloud 的原生支持,這是一個一站式的多模態 AI 推理平台。
Atlas Cloud 在單一端點下聚合了諸如 Qwen 3.6、DeepSeek v4 pro、Kimi k2.6、GLM 5.1 等高性價比模型。將 Atlas Cloud 集成到您的 AIClient2API 池中具有以下優勢:
- 無縫切換與穩定吞吐:您可以流暢地在 DeepSeek 的推理能力、Qwen 的語言處理能力以及多模態生成能力之間切換。底層的企業級基礎設施確保了穩定的併發速率。
- 開箱即用的模板:代碼庫中包含了 配置預設以及專用的路由路徑,讓您能立即開始使用。text
1provider_pools.json.example
對於參與 Atlas Cloud 高性價比 編碼計劃 (Coding Plan Promotion) 的開發者來說,這種設置有助於最大限度地減少基礎設施開銷。
開始使用
- 通過 Docker 部署:
- Bash
plaintext1docker run -d -p 3000:3000 -p 8085-8086:8085-8086 -p 1455:1455 -p 19876-19880:19876-19880 --restart=always -v "your_path/configs:/app/configs" --name aiclient2api justlikemaki/aiclient-2-api
- 通過 Web UI 配置:訪問 http://localhost:3000(默認密碼:admin123)添加您的憑據並可視化管理您的供應商。
- 路由流量:將您首選的 AI 桌面客戶端或後端 SDK 指向您的本地網關實例。
如需完整的實現細節、文檔和高級配置選項,請訪問 GitHub 倉庫。







