Trong bối cảnh AI bùng nổ với hàng chục nhà cung cấp LLM khác nhau — OpenAI, Anthropic, Google, DeepSeek — việc quản lý nhiều API key, theo dõi chi phí và đảm bảo tương thích định dạng giữa các model trở thành cơn đau đầu thực sự. New API ra đời để giải quyết chính xác vấn đề đó: một cổng gateway duy nhất cho mọi model AI.
Với hơn 45.000 star trên GitHub, 304 contributor và cập nhật liên tục (release mới nhất là v1.0.0-rc.25 vào tháng 8/2026), New API đã chứng minh mình là một trong những dự án AI gateway phổ biến nhất hiện nay. Bài viết này sẽ phân tích chi tiết những gì New API mang lại, ai nên dùng, và liệu nó có thực sự đáng để triển khai hay không.
New API là một gateway AI mã nguồn mở với hơn 45.000 star trên GitHub, cho phép tập trung quản lý và phân phối nhiều model LLM từ một nơi duy nhất. Nó hỗ trợ chuyển đổi qua lại giữa các định dạng OpenAI, Claude và Gemini, kèm theo hệ thống billing, quản lý quyền và routing thông minh. Phù hợp cho cả cá nhân muốn gộp nhiều API key lẫn doanh nghiệp cần quản lý chi phí AI nội bộ.
Thông tin tổng quan
| Repo | QuantumNous/new-api |
|---|---|
| Stars / Forks | ⭐ 45,512 / 10,776 |
| Ngôn ngữ | Go (76%), TypeScript (23%), CSS (1%) |
| License | AGPL-3.0 |
| Contributors | 304 |
| Release mới nhất | v1.0.0-rc.25 |
| Cập nhật cuối | 18/08/2026 |
| Website | https://www.newapi.ai |
new-api là gì?
New API là một hệ thống gateway và quản lý tài nguyên AI mã nguồn mở, được viết chủ yếu bằng Go (76%) và TypeScript (23%). Nói đơn giản, nó đóng vai trò như một “tổng đài” đứng giữa ứng dụng của bạn và các nhà cung cấp AI — bạn chỉ cần gọi đến một endpoint duy nhất, New API sẽ lo phần còn lại: chuyển đổi định dạng, cân bằng tải, retry khi lỗi, và ghi nhận chi phí.
Dự án được fork và phát triển mạnh từ One API (tương thích hoàn toàn database cũ), nhưng bổ sung rất nhiều tính năng mới: giao diện hiện đại, hỗ trợ đa ngôn ngữ, billing chi tiết theo cache hit, chuyển đổi qua lại giữa OpenAI ⇄ Claude ⇄ Gemini, và hệ thống xác thực đa dạng (Discord, Telegram, OIDC). Bối cảnh ra đời là nhu cầu thực tế của các tổ chức cần một lớp trung gian để quản lý hàng chục API key từ nhiều provider khác nhau mà không phải sửa code ứng dụng.
Tính năng chính
- Chuyển đổi định dạng đa chiều — Tự động convert giữa OpenAI Compatible, Claude Messages và Google Gemini format, giúp ứng dụng chỉ cần code một lần mà dùng được mọi model.
- Intelligent Routing — Hỗ trợ weighted random giữa các channel, tự động retry khi upstream lỗi, rate limiting theo user, đảm bảo uptime cao.
- Billing & Cost Accounting chi tiết — Tính phí theo request, theo usage, theo cache hit cho OpenAI, Azure, DeepSeek, Claude, Qwen. Hỗ trợ tích hợp EPay, Stripe cho nạp tiền nội bộ.
- Hỗ trợ model đa dạng — Không chỉ chat completion mà còn image generation, audio (TTS/STT), video, embedding, rerank (Cohere, Jina), Midjourney Proxy, Suno API, và cả OpenAI Realtime API.
- Quản lý quyền và xác thực mạnh — Token grouping, model restriction, user management, đăng nhập qua Discord/Telegram/LinuxDO/OIDC. Hệ thống session có giới hạn concurrent login, audit log.
- Reasoning Effort Control — Điều chỉnh mức độ suy luận cho các model thinking như o3-mini, GPT-5, Claude 3.7 Sonnet, Gemini 2.5 chỉ bằng cách thêm suffix vào tên model.
- Giao diện hiện đại, đa ngôn ngữ — UI mới với dashboard trực quan, hỗ trợ 5 ngôn ngữ (Trung giản thể, phồn thể, Anh, Pháp, Nhật).
- Tương thích ngược One API — Migrate từ One API sang không mất dữ liệu, giảm rủi ro khi chuyển đổi.
Yêu cầu phần cứng & hệ thống
| Thành phần | Yêu cầu |
|---|---|
| CPU | Bất kỳ CPU 64-bit (amd64 hoặc arm64), không hỗ trợ 32-bit |
| RAM | Tối thiểu 512MB, khuyến nghị 1GB+ nếu phục vụ nhiều người dùng (ước tính) |
| Ổ cứng | Tối thiểu 1GB cho Docker image + dữ liệu SQLite; nhiều hơn nếu dùng MySQL/PostgreSQL riêng (ước tính) |
| OS | Linux (khuyến nghị), macOS, Windows — bất kỳ OS chạy được Docker |
| Phần mềm nền | Docker / Docker Compose; Database: SQLite (mặc định), MySQL ≥ 5.7.8 hoặc PostgreSQL ≥ 9.6; Redis (tùy chọn) |
| GPU/VRAM | Không yêu cầu — đây là gateway/proxy, không chạy inference trực tiếp |
Cách cài đặt và sử dụng
Cách cài đặt nhanh nhất là dùng Docker Compose:
1. Clone repo: git clone https://github.com/QuantumNous/new-api.git && cd new-api
2. Chỉnh sửa file cấu hình: nano docker-compose.yml — thiết lập các biến môi trường như SQL_DSN, SESSION_SECRET, REDIS_CONN_STRING tùy nhu cầu.
3. Khởi chạy: docker-compose up -d
4. Truy cập http://localhost:3000 để bắt đầu sử dụng.
Nếu muốn dùng Docker thuần, có thể pull image calciumion/new-api:latest và chạy với SQLite (mặc định) hoặc MySQL. Lưu ý mount volume -v ./data:/data để không mất dữ liệu khi restart container. Tài liệu chi tiết có tại docs.newapi.pro.
Phù hợp với ai?
Nên dùng: DevOps và backend developer cần tập trung quản lý nhiều API key AI từ một gateway duy nhất. Doanh nghiệp vừa và lớn muốn kiểm soát chi phí AI nội bộ, phân quyền truy cập model cho các team. Startup hoặc cá nhân cung cấp dịch vụ AI proxy/resale cần billing tự động. Những ai đang dùng One API và muốn upgrade lên bản có nhiều tính năng hơn.
Không nên dùng: Người hoàn toàn mới với Docker và quản trị hệ thống — dù cài đặt không quá phức tạp nhưng vẫn cần kiến thức cơ bản về container, networking và biến môi trường. Những ai chỉ cần gọi một provider AI duy nhất thì gateway này có thể overkill.
Ứng dụng thực tế
- Quản lý AI nội bộ doanh nghiệp: Cấp quota cho từng phòng ban, theo dõi chi phí sử dụng GPT-4, Claude, Gemini từ dashboard tập trung.
- Xây dựng dịch vụ AI proxy: Tạo platform cho phép khách hàng nạp tiền và sử dụng nhiều model qua một API key duy nhất, với billing tự động qua Stripe.
- Tăng reliability cho ứng dụng AI: Cấu hình nhiều channel cùng model, khi OpenAI down thì tự động failover sang Azure hoặc provider khác.
- Chuẩn hóa API cho team phát triển: Frontend/backend chỉ cần code theo format OpenAI, New API lo chuyển đổi sang Claude hay Gemini phía sau.
- Nghiên cứu và giáo dục: Các lab đại học (như Peking University — đối tác chính thức) dùng để phân phối quota AI cho sinh viên và nhà nghiên cứu.
Đánh giá của danhbaai.com
New API là một trong những dự án AI gateway mã nguồn mở hoàn thiện nhất hiện tại. Với hơn 45.000 star, 304 contributor và tần suất cập nhật rất cao (push mới nhất chỉ vài giờ trước), dự án cho thấy sức sống cộng đồng mạnh mẽ. Khả năng chuyển đổi định dạng đa chiều giữa OpenAI, Claude và Gemini là điểm khác biệt lớn so với các giải pháp tương tự như LiteLLM hay One API gốc.
Tuy nhiên, con số 1.276 issue đang mở là đáng lưu ý — phản ánh cả mức độ phổ biến lẫn độ phức tạp của dự án. Tài liệu chính thức khá đầy đủ nhưng phần lớn nội dung gốc bằng tiếng Trung, bản tiếng Anh đôi khi chưa cập nhật kịp. So với LiteLLM (Python-based), New API có ưu thế về hiệu năng nhờ Go, giao diện quản trị đẹp hơn, và billing tích hợp sẵn; nhưng LiteLLM lại dễ extend hơn cho Python developer.
Tổng kết: nếu bạn cần một gateway AI self-hosted nghiêm túc với quản lý chi phí, phân quyền và multi-provider — New API là lựa chọn hàng đầu đáng cân nhắc. Chỉ cần chấp nhận rằng đây vẫn là bản RC và sẽ cần theo dõi cập nhật thường xuyên.
- Hỗ trợ chuyển đổi định dạng đa chiều giữa OpenAI, Claude, Gemini — rất ít gateway làm được
- Hệ thống billing chi tiết tích hợp sẵn với Stripe/EPay, tính cả cache hit
- Hiệu năng cao nhờ backend Go, phù hợp triển khai production
- Cộng đồng cực lớn (45K+ star, 300+ contributor), cập nhật liên tục
- Tương thích ngược One API, migrate dễ dàng
- Giao diện quản trị hiện đại với dashboard trực quan
- 1.276 issue mở — cho thấy nhiều bug/feature request chưa được giải quyết
- Vẫn ở bản RC (v1.0.0-rc.25), chưa có stable release chính thức
- Tài liệu gốc chủ yếu tiếng Trung, bản tiếng Anh chưa đồng bộ hoàn toàn
- Cấu hình biến môi trường khá phức tạp, người mới dễ bị choáng
- Chuyển đổi Gemini → OpenAI chỉ hỗ trợ text, chưa có function calling
Câu hỏi thường gặp
New API có miễn phí không?
Tôi đang dùng One API, có nên chuyển sang New API không?
New API có cần GPU không?
New API hỗ trợ những provider AI nào?
Có thể dùng New API để bán lại API cho người khác không?
Nguồn: github.com/QuantumNous/new-api — Bài phân tích bởi danhbaai.com.
