Self-hosted multi-protocol AI API proxy for Antigravity, Codex, Grok, Kiro, OpenAI, Claude, and custom providers. Supports OpenAI-compatible API, Claude API, Gemini protocol conversion, GPT, Grok Build, Claude Opus, Gemini Pro, Kimi, MiniMax, provider pools, smart routing, and automatic failover.

AIClient2API (A2) – 面向客户端专用 LLM API 的统一代理

简介 – 基于 Node.js 的服务器，位于您的应用程序和多种“客户端专用”大模型服务（Google Gemini、Antigravity、Codex、xAI Grok、Kiro、Claude 等）之间。它将这些服务的专有请求/响应格式重写为标准的 OpenAI REST API，使任何兼容 OpenAI 的工具（Cherry-Studio、NextChat、Cline 等）都能像调用普通 OpenAI 端点一样调用它们。

核心概念

特性	为何重要
OpenAI 兼容接口	现有工具无需修改代码，只需指向代理 URL。
多模型支持	一个配置即可访问数十种模型（Gemini、Claude、Grok、Codex、Kiro、MiniMax 等）。
策略/适配器架构	每个提供商都有自己的适配器，知道如何在提供商的原生协议和 OpenAI 模式之间进行转换。
账户池与故障转移	可加载多个凭据；代理会轮换它们，在失败时重试，并优雅降级，实现约 99.9% 的正常运行时间。
TLS 指纹伪装	内置的 Go uTLS 附属进程模拟真实浏览器，绕过会阻止自动调用的 Cloudflare/403 阻止。
Agent 优先设计	为 AI 代理（OpenClaw、Hermes、Claude Code）提供钩子，使其能够通过“技能”文件自动发现服务。
全链路日志	记录每个请求和响应，支持审计、调试和创建私有数据集。

工作原理（高层流程）

客户端请求 – 您的应用发送普通的 OpenAI 风格 HTTP 请求（例如 POST /v1/chat/completions）。
路由 – 代理检查路径和 model 字段，决定使用哪个提供商的适配器。
适配器 – 选定的适配器：
- 向目标服务进行身份验证（OAuth、Cookie、API 密钥）。
- 将 OpenAI JSON 负载转换为提供商的原生格式。
- 发送请求（通常通过 TLS 伪装连接）。
响应处理 – 将提供商的响应转换回 OpenAI JSON（如果支持，包括流式 data 事件）。
日志与健康检查 – 所有流量均被记录；健康检查端点监控提供商可用性，并在需要时轮换账户。

快速开始

步骤	命令/操作
使用 Docker 运行	`docker run -d -p 8080:8080 -v /my/configs:/app/configs justlikemaki/aiclient-2-api`
配置提供商	编辑 `configs/provider_pools.json`（提供示例文件），列出要公开的每个模型的凭据。
指向工具	将 API 基础 URL 设置为 `http://localhost:8080/v1`（或服务器的地址）。
可选 UI	Web 控制台（2025 年 11 月新增）可实时查看健康状态、日志和切换模型。

值得注意的近期更新（2026 年）

Grok Build 支持 – xAI Grok 的 OAuth 流程，包括多模态生成和内置工具（网络搜索、代码解释器、文件附件）。
Deep AI 集成 – 自动生成的 /api/help 和 /api/example 端点，使 AI 代理能够发现全部 50 多个 API 路由。
图像生成 – 完整地将 OpenAI /v1/images/generations 和 /v1/images/edits 转换为各提供商的原生图像 API。
提供商池管理器 – 异步刷新队列、去重、全局并发限制和自动令牌过期处理。

谁会使用它？

开发者 – 围绕 OpenAI API 构建了工具，但想利用更便宜或免费且被锁定在浏览器专用客户端中的模型。
团队 – 需要为多个 LLM 供应商提供单一端点的团队（例如，SaaS 希望让客户选择 Claude、Gemini 或 Grok 而无需重写集成代码）。
AI 代理 – 可以加载提供的“技能”文件，了解如何自动调用代理。

许可证与社区

GPL-v3 – 源代码开放；欢迎贡献。
Docker Hub – 预构建镜像，拉取次数超过 10 万。
文档 – 多语言（EN、ZH、JA）以及 https://aiproxy.justlikemaki.vip/en/ 上的完整在线指南。
支持 – 由多个 API 中继服务（PackyCode、RunningHub、AxisNow 等）赞助，为使用此代理的用户提供折扣代码。

TL;DR

AIClient2API 是一个 Node.js 代理，它将“客户端专用”的 LLM 服务转换为标准的 OpenAI 兼容 API，处理身份验证、协议转换、账户池化甚至 TLS 指纹伪装。它允许任何支持 OpenAI 的应用程序无需修改代码即可使用 Gemini、Claude、Grok 和 Codex 等模型，同时提供日志、健康监控和代理友好的技能文件。

justlovemaki/AIClient2API