AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
把多家客户端专用大模型 API 统一封装成本地 OpenAI 兼容接口的自托管代理。
AIClient2API 是一个自托管的多协议 AI API 代理,可接入 Antigravity、Codex、Grok、Kiro、OpenAI、Claude 及自定义服务商。它模拟客户端请求,将结果封装为本地 OpenAI 兼容接口,并支持 Claude API、Gemini 协议转换、服务商池、智能路由和自动故障切换。
推荐指数
适合需要统一管理多家模型入口、做协议转换和故障切换的开发者,功能实用但需注意合规与稳定性。
近 7 天
+10
新增 Star
总 Star 排名
#759
雷达追踪的 3,958 个 AI 仓库中
创建于
2025
2025年7月20日
核心亮点
1多协议统一
将 OpenAI、Claude、Gemini 等不同协议统一为本地 OpenAI 兼容接口。
2服务商池
支持配置多个服务商,按策略路由请求并自动故障切换。
3客户端模拟
模拟 Antigravity、Codex、Grok、Kiro 等客户端请求,封装为 API。
4自托管部署
提供 Docker 镜像,可在本地或服务器自行部署运行。
5多模型覆盖
支持 GPT、Claude Opus、Gemini Pro、Kimi、MiniMax 等模型。
适用场景
统一模型入口
例如:在本地部署后,用同一个 OpenAI 兼容地址调用 Claude、Gemini 和 GPT。
协议转换
例如:把 Claude API 请求转换为 Gemini 协议,或反向转换,适配不同客户端。
故障切换
例如:配置多个服务商池,主服务商不可用时自动切换到备用服务商。
客户端 API 化
例如:将 Codex、Grok 等客户端专用接口封装为本地 API,供其他工具调用。
它是怎么工作的
第 1 步
配置服务商
在配置文件中填入各服务商的凭据和端点信息。
第 2 步
启动代理
通过 Docker 或 Node.js 启动本地代理服务。
第 3 步
接收请求
代理接收 OpenAI 兼容格式的请求,按路由规则选择服务商。
第 4 步
协议转换
将请求转换为目标服务商协议,模拟客户端发送。
第 5 步
返回结果
将响应转换回 OpenAI 兼容格式返回给调用方,失败时自动切换。
快速上手
- 1
Docker 部署
使用官方镜像启动容器,映射端口并挂载配置。
docker run -d -p 3000:3000 justlikemaki/aiclient-2-api - 2
Node.js 运行
需 Node.js ≥20,克隆仓库后安装依赖并启动。
npm install && npm start - 3
配置服务商
按文档填写服务商凭据和路由规则。
- 4
调用接口
将客户端 base URL 指向本地代理地址,使用 OpenAI 兼容格式调用。
适合谁
- 需要统一管理多家模型入口的开发者
- 需要做 OpenAI/Claude/Gemini 协议转换的开发者
- 希望自托管代理并配置故障切换的团队
- 想将客户端专用 API 封装为本地接口的用户
不太适合
- 不想自行部署和维护服务的普通用户
- 对合规性要求严格、不允许模拟客户端请求的场景
成熟度
- 活跃度最近更新于 2026 年 11 月,star 数近 9000,issue 仅 10 个,维护活跃。
- 文档README 提供多语言版本和文档链接,但部分配置细节需查阅外部文档。
- 社区star 和 fork 数较高,Docker 下载量超 10 万,有赞助商支持。
- 上手难度需要自行部署和配置服务商,对非技术用户有一定门槛。
同类项目怎么选
- LiteLLM更偏向统一多家模型 API 的 SDK/代理,协议转换和客户端模拟能力不同。
- One API侧重 API 密钥管理和分发,本项目侧重客户端请求模拟与协议转换。
- New API类似 One API 的接口管理与分发平台,本项目更强调多协议适配和故障切换。
使用前注意
- · 采用 GPL-3.0 许可证,商用或分发需遵守相应条款。
- · 模拟客户端请求可能违反部分服务商的使用条款,需自行评估合规风险。
- · 需要 Node.js ≥20 或 Docker ≥20 环境,并自行维护服务稳定性。
- · 服务商凭据需妥善保管,自托管时注意网络安全配置。
