justlovemaki GitHub avatar

AIClient2API

JavaScript
多协议AI代理justlovemaki最近推送 2026年11月18日
模型推理与部署GPL-3.08,9921,40210 issues7 天 +10

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

把多家客户端专用大模型 API 统一封装成本地 OpenAI 兼容接口的自托管代理。

AIClient2API 是一个自托管的多协议 AI API 代理,可接入 Antigravity、Codex、Grok、Kiro、OpenAI、Claude 及自定义服务商。它模拟客户端请求,将结果封装为本地 OpenAI 兼容接口,并支持 Claude API、Gemini 协议转换、服务商池、智能路由和自动故障切换。

推荐指数

4.0

适合需要统一管理多家模型入口、做协议转换和故障切换的开发者,功能实用但需注意合规与稳定性。

近 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. 第 1 步

    配置服务商

    在配置文件中填入各服务商的凭据和端点信息。

  2. 第 2 步

    启动代理

    通过 Docker 或 Node.js 启动本地代理服务。

  3. 第 3 步

    接收请求

    代理接收 OpenAI 兼容格式的请求,按路由规则选择服务商。

  4. 第 4 步

    协议转换

    将请求转换为目标服务商协议,模拟客户端发送。

  5. 第 5 步

    返回结果

    将响应转换回 OpenAI 兼容格式返回给调用方,失败时自动切换。

快速上手

  1. 1

    Docker 部署

    使用官方镜像启动容器,映射端口并挂载配置。

    docker run -d -p 3000:3000 justlikemaki/aiclient-2-api
  2. 2

    Node.js 运行

    需 Node.js ≥20,克隆仓库后安装依赖并启动。

    npm install && npm start
  3. 3

    配置服务商

    按文档填写服务商凭据和路由规则。

  4. 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 环境,并自行维护服务稳定性。
  • · 服务商凭据需妥善保管,自托管时注意网络安全配置。

主题标签

aicodingfreeantigravitycodexgrokkiroclaudeopenai