统一多模态 AI 推理：为什么选择 AIClient2API？

在构建 AI 应用或进行智能体（Agentic）工作流原型开发时，我们经常需要尝试多种大语言模型以找到最优方案。然而，由于不同提供商使用截然不同的 API 结构和协议，切换模型通常需要繁琐的代码重构，并不断更新后端逻辑。

AIClient2API 正是为解决这一挑战而生。它作为一个智能代理层，能够模拟来自 Gemini CLI、Antigravity、Codex、Grok 和 Kiro 等平台的客户端请求，并将它们封装为统一的、兼容 OpenAI 的 API 接口。除了协议统一化，它还提供了一个 Web UI 面板，用于监控各节点的实时状态。

核心功能

零成本模型切换：使用标准的 OpenAI SDK 格式编写一次集成代码，即可动态切换后端提供商，无需修改任何业务逻辑。
可视化管理控制台：内置 Web UI 面板，用于实时配置管理、健康状态监控、通过内置 Playground 进行 API 测试以及审计请求日志。

技术架构与实现

该项目基于“AI 优先”的模块化架构，采用 Node.js 构建，旨在处理协议转换并保持高可用性：

plaintext
1[ 您的应用 (Cherry-Studio / Cline / 自定义代码) ]
2                           │ (标准 OpenAI / Claude 请求)
3                           ▼
4            ┌─────────────────────────────┐
5            │     AIClient2API 网关       │
6            └──────────────┬──────────────┘
7                           │
8             ┌─────────────┴─────────────┐
9             ▼                           ▼
10     ┌──────────────┐            ┌──────────────┐
11     │  适配器 (Adapters) │            │ 提供商池 (Provider Pool)│
12     └───────┬──────┘            └───────┬──────┘
13             │                           │ (健康检查 / 冷却)
14             ▼                           ▼
15     ┌──────────────┐            ┌──────────────┐
16     │ TLS 侧边车   │            │ 故障转移与   │
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 语言编写的 TLS Sidecar 代理（基于 uTLS）。它能够模拟标准的 Chrome TLS 握手并自动处理 HTTP/2 协商，从而规避 403 Forbidden 错误。

生态集成：原生支持 AtlasCloud

atlascloud

在最近的更新中，AIClient2API 引入了对 AtlasCloud 的原生支持，这是一个一体化的多模态 AI 推理平台。

AtlasCloud 在单个端点下聚合了诸如 Qwen 3.6、DeepSeek v4 pro、Kimi k2.6、GLM 5.1 等高性价比模型。将 AtlasCloud 集成到你的 AIClient2API 池中具有以下优势：

无缝切换与稳定吞吐：你可以在 DeepSeek 的推理能力、Qwen 的语言处理能力和多模态生成之间无感切换，底层企业级基础设施确保了稳定的并发性能。
开箱即用的模板：项目仓库在
text
```
1provider_pools.json.example
```
中提供了配置预设以及专门的路由路径，助你快速上手。

此方案非常适合参与 AtlasCloud 预算友好型 编程计划促销 (Coding Plan Promotion) 的开发者，以最大限度地降低基础设施开销。

快速开始

通过 Docker 部署：
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