統一多模態 AI 推論:為什麼你應該試試 AIClient2API

AIClient2API 作為一個智慧代理層,可模擬來自 Gemini CLI、Antigravity、Codex、Grok 和 Kiro 等平台的客戶端請求,並將其封裝為單一、標準化且相容於 OpenAI 的 API 介面。除了協定統一之外,它還提供了 Web UI 儀表板,用於監控每個節點的即時狀態。

統一多模態 AI 推論:為什麼你應該試試 AIClient2API

在構建 AI 應用程序或原型設計智能體(Agentic)工作流時,我們經常需要嘗試多種大型語言模型以找到最佳方案。然而,由於不同的供應商使用迥異的 API 結構和協議,在它們之間切換通常需要繁瑣的代碼重構,並需持續更新後端邏輯。

AIClient2API 正是為了解決這一挑戰而生。它充當智能代理層,模擬來自 Gemini CLI、Antigravity、Codex、Grok 和 Kiro 等平台的客戶端請求,並將其封裝為單一、標準化的 OpenAI 兼容 API 接口。除了協議統一外,它還提供了一個 Web UI 面板,用於實時監控每個節點的狀態。


核心功能

  • 零成本模型切換:只需使用標準的 OpenAI SDK 格式編寫一次集成代碼,即可在不修改業務邏輯的情況下,動態切換後端供應商。
  • 可視化管理控制台:內置 Web UI 面板,用於實時配置管理、健康狀態監控、通過內置 Playground 進行 API 測試,以及請求日誌審計。

aiclient.PNG


技術架構與實現

該項目依賴於基於 Node.js 的 AI 優先模塊化架構,以處理協議轉換並保持高可用性:

plaintext
1[ 您的應用程序 (Cherry-Studio / Cline / 自定義代碼) ]
2                           │ (標準 OpenAI / Claude 請求)
34            ┌─────────────────────────────┐
5            │     AIClient2API 網關       │
6            └──────────────┬──────────────┘
78             ┌─────────────┴─────────────┐
9             ▼                           ▼
10     ┌──────────────┐            ┌──────────────┐
11     │  適配器層     │            │ 供應商池      │
12     └───────┬──────┘            └───────┬──────┘
13             │                           │ (健康檢查 / 冷卻)
14             ▼                           ▼
15     ┌──────────────┐            ┌──────────────┐
16     │ TLS Sidecar  │            │ 故障轉移與    │
17     │ (Go uTLS)    │            │ 後備機制      │
18     └───────┬──────┘            └───────┬──────┘
19             │                           │
20             └─────────────┬─────────────┘
2122   [ 後端: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 原生支持

atlascloud

在近期的更新中,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) 的開發者來說,這種設置有助於最大限度地減少基礎設施開銷。


開始使用

  1. 通過 Docker 部署
  2. Bash
plaintext
1docker 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
  1. 通過 Web UI 配置:訪問 http://localhost:3000(默認密碼:admin123)添加您的憑據並可視化管理您的供應商。
  2. 路由流量:將您首選的 AI 桌面客戶端或後端 SDK 指向您的本地網關實例。

如需完整的實現細節、文檔和高級配置選項,請訪問 GitHub 倉庫。

👉 AIClient2API

最新模型

一個 API,暢享全模態 AI。

探索全部模型

Join our Discord community

Join the Discord community for the latest model updates, prompts, and support.

統一多模態 AI 推論:為何選擇 AIClient2API?