AIClient2API: Biến mọi LLM thành API OpenAI chuẩn chỉ trong vài phút

Tóm tắt nhanh:

AIClient2API (A2) là một proxy mã nguồn mở viết bằng Node.js, hợp nhất các LLM vốn chỉ chạy trên client riêng (Gemini CLI, Antigravity, Codex, Grok, Kiro) thành một endpoint duy nhất tương thích OpenAI API.

Cho phép dùng miễn phí hoặc chi phí thấp các model cao cấp như Claude Opus 4.5, Gemini 3 Pro, Grok 4 thông qua cơ chế OAuth, vượt qua giới hạn rate-limit và TLS fingerprint (Cloudflare 403).

Hỗ trợ chuyển đổi đa giao thức giữa OpenAI, Claude và Gemini, account pool polling, tự động failover, đảm bảo độ khả dụng 99.9%.

Triển khai cực nhanh chỉ với một lệnh Docker duy nhất, đi kèm Web UI quản trị tại http://localhost:3000 (mật khẩu mặc định admin123).

Phù hợp cho lập trình viên muốn dùng Cherry-Studio, NextChat, Cline, Claude Code với nhiều model khác nhau mà không cần sửa code ứng dụng.

Trong bối cảnh các nhà cung cấp LLM như Google, Anthropic hay xAI ngày càng “khoá” các model mạnh nhất vào những client độc quyền (Gemini CLI, Antigravity, Kiro, Codex CLI…), nhu cầu có một lớp trung gian thống nhất trở nên cấp thiết hơn bao giờ hết. AIClient2API ra đời để giải quyết chính bài toán đó.

AIClient2API là gì

AIClient2API (viết tắt là A2) là một dịch vụ proxy API mã nguồn mở được phát triển bởi justlovemaki trên GitHub. Mục tiêu của dự án là phá vỡ giới hạn của các client độc quyền, biến các LLM miễn phí (chỉ chạy trên client) thành endpoint chuẩn tương thích với OpenAI mà bất kỳ ứng dụng nào cũng có thể gọi.

Kiến trúc của A2 dựa trên Node.js, áp dụng strategy pattern và adapter pattern, cho phép:

Tích hợp Gemini, Claude, Grok, Codex, Kimi K2, MiniMax M2 trong cùng một interface
Chuyển đổi qua lại giữa ba giao thức OpenAI / Claude / Gemini một cách thông minh
Quản lý account pool, polling thông minh, failover tự động và health-check
Ghi log toàn bộ request và response để phục vụ kiểm thử hoặc xây dataset huấn luyện riêng

Vì sao bạn nên dùng AIClient2API

Hợp nhất truy cập, một interface cho tất cả model

Thay vì viết code riêng cho từng API, bạn chỉ cần cấu hình một lần. Mọi tool sẵn có tương thích OpenAI như Cherry-Studio, NextChat, Cline, Open WebUI đều có thể trỏ tới A2 và sử dụng các model mạnh nhất hiện nay mà không cần sửa dòng code nào.

Vượt qua giới hạn của nhà cung cấp

A2 tận dụng cơ chế OAuth của Gemini, Antigravity để bỏ qua các hạn mức gọi API thông thường. Đặc biệt, dự án tích hợp sẵn TLS Sidecar viết bằng Go (uTLS) nhằm giả lập fingerprint trình duyệt, qua đó bypass thành công các chặn Cloudflare 403 thường gặp khi gọi Grok.

Dùng model cao cấp miễn phí hoặc giá rẻ

Thông qua chế độ Kiro API, người dùng có thể sử dụng Claude Opus 4.5 gần như miễn phí (Kiro tặng 500 credit cho tài khoản mới). Tương tự, Antigravity cho phép truy cập Gemini 3 Pro và Claude Sonnet 4.5 thông qua kênh nội bộ của Google.

Các tính năng nổi bật của phiên bản mới nhất

A2 cập nhật rất nhanh và đã đạt phiên bản v3.0.0 với nhiều bước nhảy quan trọng:

AI-First Architecture: tích hợp Skill guide và endpoint /api/help, /api/example cho phép AI Agent tự học toàn bộ 50+ endpoint
Image Generation: hỗ trợ /v1/images/generations và /v1/images/edits chuẩn OpenAI, tự động convert sang giao thức ảnh native của từng nhà cung cấp
Grok Cookie/SSO: hỗ trợ Grok 3, Grok 4, thinking model, sinh ảnh và sinh video
Web UI v2: quản trị trực quan, theme tối/sáng, real-time log, health monitor
Account Pool Manager: async refresh queue, deduplication, concurrency control, node warmup

Hướng dẫn cài đặt AIClient2API

Có hai cách chính để triển khai A2: dùng Docker (khuyến nghị) hoặc chạy script trực tiếp trên Node.js.

Cách 1: Triển khai bằng Docker (nhanh nhất)

Chỉ với một dòng lệnh duy nhất, bạn đã có ngay một dịch vụ A2 chạy nền:

docker run -d \
  -p 3000:3000 \
  -p 8085-8086:8085-8086 \
  -p 1455:1455 \
  -p 19876-19880:19876-19880 \
  --restart=always \
  -v "/home/user/aiclient-configs:/app/configs" \
  --name aiclient2api \
  justlikemaki/aiclient-2-api

Giải thích các tham số chính:

Port 3000: Web UI quản trị
Port 8085, 8086, 1455, 19876-19880: dành cho callback OAuth của Gemini, Antigravity, Codex, Kiro
Volume /app/configs: nơi lưu credential và file cấu hình, hãy thay bằng đường dẫn thật trên máy bạn

Hoặc dùng Docker Compose:

cd docker
mkdir -p configs
docker compose up -d

Cách 2: Cài trực tiếp bằng script

Sau khi git clone repo từ GitHub về:

Linux / macOS: chmod +x install-and-run.sh && ./install-and-run.sh
Windows: nhấp đúp vào file install-and-run.bat

Nếu muốn tự kiểm soát quá trình hơn:

npm install
npm start                  # chạy mặc định
npm run help               # xem trợ giúp
npm run example:api        # xem ví dụ gọi API
npm start -- --no-ui       # chạy backend-only, không bật Web UI

Lưu ý quan trọng cho người chạy trực tiếp: nếu cần bypass TLS cho Grok, bạn phải cài Go 1.20+ và build TLS Sidecar:

cd tls-sidecar && go build -o tls-sidecar && cd ..

Truy cập Web UI và cấu hình lần đầu

Sau khi server khởi động thành công, mở trình duyệt và truy cập:

http://localhost:3000

Mật khẩu mặc định là admin123 (đổi ngay sau khi đăng nhập bằng cách sửa file pwd). Trong Web UI bạn sẽ thấy 5 mục chính:

Dashboard: tổng quan hệ thống, ví dụ routing tương tác và hướng dẫn cấu hình client
Configuration: nhập API key hoặc upload file OAuth, chuyển đổi default provider real-time
Provider Pools: giám sát connection, health, bật/tắt từng pool
Config Files: quản lý tập trung file credential OAuth
Real-time Logs: xem log system và request real-time

Để thêm một tài khoản Gemini chẳng hạn, vào Provider Pools, nhấn Generate Authorization, mở link trong trình duyệt, hoàn tất đăng nhập Google và A2 sẽ tự lưu credential vào configs/.

Cách sử dụng A2 với ứng dụng có sẵn

Vì A2 mô phỏng hoàn toàn endpoint OpenAI, bạn chỉ cần trỏ Base URL của client (Cherry-Studio, NextChat, Cline, Claude Code, ChatBox…) tới:

http://localhost:3000/v1

Và dùng Bearer your-api-key (key tự định nghĩa trong cấu hình). Ví dụ gọi Claude Opus 4.5 qua Kiro với extended thinking:

curl http://localhost:3000/claude-kiro-oauth/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "thinking": { "type": "enabled", "budget_tokens": 10000 },
    "messages": [{ "role": "user", "content": "Solve this step by step." }]
  }'

Để chuyển sang Gemini, chỉ cần đổi path thành /gemini-cli-oauth/... hoặc thay đổi model field. A2 sẽ tự động routing và convert giao thức.

Một số lưu ý quan trọng khi sử dụng

Trước khi triển khai cho công việc thực tế, bạn nên cân nhắc các điểm sau:

Đây là dự án mã nguồn mở phục vụ nghiên cứu, việc sử dụng cần tuân thủ điều khoản dịch vụ của từng nhà cung cấp như Google, Anthropic, xAI.
Một số kênh (như Antigravity Pro) đã đóng kênh đăng ký mới, nên kiểm tra trước khi mua tài khoản.
Luôn dùng mật khẩu mạnh và đặt A2 sau reverse-proxy có HTTPS nếu mở public.
File credential OAuth là nhạy cảm, không commit vào Git và không chia sẻ nơi công cộng.

AIClient2API là một công cụ thực sự đáng giá cho bất kỳ developer, indie hacker hay AI enthusiast nào muốn tận dụng tối đa các LLM hàng đầu mà không bị khoá vào một client duy nhất. Với Docker one-line deploy, Web UI thân thiện, hỗ trợ đa giao thức và cập nhật cực nhanh, A2 có thể coi là “Swiss Army Knife” trong arsenal của người dùng AI hiện đại.

Bạn có thể bắt đầu khám phá ngay tại trang GitHub chính thức của AIClient2API hoặc kéo image trực tiếp từ Docker Hub. Chỉ vài phút sau, bạn sẽ có trong tay một gateway thống nhất, mạnh mẽ và hoàn toàn nằm trong tầm kiểm soát của chính mình.

Duy Nghiện

Hãy làm khán giả, đừng làm nhân vật chính :)