AIClient-2-API官网使用入口，开源的AI客户端接口适配工具

AIClient-2-API是一款开源的AI客户端接口适配工具，基于GNU GPL v3协议开源，核心目标是打通不同AI服务商（如Gemini、OpenAI、Claude等）的接口差异，提供统一的API调用层，让开发者无需适配各平台原生接口即可快速集成多厂商AI能力。工具支持HTTP接口标准化、多格式请求适配（流式/非流式）、认证鉴权等核心能力，且提供开箱即用的部署和管理能力。

AIClient-2-API平台核心特点：

1、多厂商适配与接口标准化：

– 原生支持 Gemini（CLI OAuth）、OpenAI（Custom）、Claude（Custom/Kiro OAuth）等主流 AI 厂商；

– 统一输出 OpenAI 兼容的 `/v1/chat/completions` 接口，流式（SSE）/非流式请求均支持；

– 支持各厂商原生接口格式透传，兼顾标准化与灵活性。

2、便捷的部署与运维：

– 提供一键安装启动脚本（`install-and-run.sh`/`install-and-run.bat`），自动检测 Node.js 环境、安装依赖、拉取最新代码；

– 内置 Docker 健康检查脚本（`healthcheck.js`），支持容器化部署的存活检测；

– 管理界面支持多语言（中文/英文）、密码鉴权，保障接口访问安全。

3、灵活的扩展与适配能力：

– 支持自定义模型提供商配置（`provider_pools.json`）、插件扩展（`plugins.json`）；

– 支持 API Key 管理、OAuth 凭证适配，适配不同厂商的认证方式；

– 源码开源可定制，可扩展新增 AI 厂商适配、自定义请求/响应拦截逻辑。

4、完善的测试与可靠性保障：

– 提供 HTTP 集成测试套件（`api-integration.test.js`），覆盖流式/非流式请求、多厂商适配场景；

– 健康检查接口（`/health`）实时监控服务状态，超时自动检测异常；

– 日志与错误处理完善，便于问题定位与运维。

AIClient-2-API快速上手教程：

前置条件：

– 安装 Node.js（推荐 LTS 版本，[下载地址](https://nodejs.org/)）；

– 可选：安装 Git（用于拉取最新代码）、pnpm（加速依赖安装）。

步骤 1：获取源码：

# 克隆仓库（若已有源码可跳过）
git clone <仓库地址>
cd AIClient-2-API

步骤 2：一键安装与启动：

#Linux/macOS
# 赋予脚本执行权限
chmod +x install-and-run.sh
# 启动（--pull 可选，拉取最新代码）
./install-and-run.sh --pull


#Windows
# 直接运行批处理脚本
install-and-run.bat --pull

脚本会自动完成：

1、检查 Node.js/npm/pnpm 环境；

2、安装项目依赖；

3、验证核心文件（如 `src/core/master.js`）；

4、启动服务器（默认地址：http://localhost:3000）。

步骤 3：登录管理界面：

1、访问 http://localhost:3000，进入登录页；

2、输入配置的密码（默认需在配置文件中设置），完成鉴权；

3、在管理界面配置 AI 厂商凭证、模型映射、API 密钥等。

步骤 4：调用标准化 API：

以 OpenAI 兼容接口为例，调用 Gemini 模型：

curl http://localhost:3000/v1/chat/completions \
  -H "Authorization: Bearer <你的API密钥>" \
  -H "model-provider: gemini-cli-oauth" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role": "user", "content": "2+2等于多少？"}],
    "stream": false
  }'

AIClient-2-API典型应用场景：

1、多AI厂商聚合应用开发：

开发者无需分别适配 Gemini、OpenAI、Claude 的原生接口，基于 AIClient-2-API 的标准化接口即可快速开发「AI 聚合聊天工具」「多模型对比平台」，降低对接成本。

2、企业内部AI能力统一封装：

企业可通过 AIClient-2-API 封装内部可用的 AI 能力，统一鉴权、流量控制、日志审计，同时灵活切换底层 AI 厂商（如从 OpenAI 切换到 Claude 无需修改业务代码）。

3、本地化部署AI接口网关：

对于需要私有化部署的场景，AIClient-2-API 可作为 AI 接口网关，对接本地部署的大模型或私有云 AI 服务，对外提供标准化接口，适配企业内网安全策略。

4、AI应用原型快速验证：

开发者可快速验证不同 AI 模型的效果：通过切换 `model-provider` 头信息，即可在同一接口下测试 Gemini、OpenAI、Claude 的响应效果，加速原型迭代。

5、容器化/云原生部署：

结合 Docker 健康检查脚本（`healthcheck.js`），可将 AIClient-2-API 部署到 K8s/容器平台，实现服务自动扩缩容、故障自愈，适配生产环境需求。

进入AIClient-2-API官网入口