New API 是一款开源的大模型统一网关与 AI 资产管理系统，旨在解决多模型接入复杂、计费混乱及运维困难等问题。它支持 OpenAI、Claude、Gemini 等 30+ 服务商的接口统一与格式转换，具备智能路由、高可用、精细计费和多租户管理功能。系统提供现代化管理后台，支持 Docker 快速部署，适用于个人开发者、企业及公益站构建低成本、高效率的 AI 基础设施。
在 2025-2026 年的 AI 浪潮中，开发者们面临的最大痛点不再是'有没有好模型'，而是'怎么高效、低成本、安全地用好几十个模型'。
OpenAI 的 GPT-5 系列推理能力顶尖，但价格高昂且有速率限制；Anthropic 的 Claude 3.7 Sonnet 在长上下文和思考模式上无敌，却接口完全不同；Google Gemini 2.5 系列多模态强悍，价格亲民，但 API 格式又是另一套；国内的通义千问、DeepSeek、豆包、文心一言、混元……每个平台都有自己的 Base URL、鉴权方式、计费规则、限流策略。更别提 Midjourney 绘画、Suno 音乐生成、Rerank 重排序、Realtime 实时语音对话这些非标准接口。
手动为每个应用适配？维护几十份配置文件？每次新模型出来就要改代码？企业内部多用户、多部门、多预算怎么管控？个人公益站怎么实现充值、配额、计费闭环？
New API（https://github.com/QuantumNous/new-api）正是为解决这些痛点而生的'下一代 LLM 网关 + AI 资产管理系统'。
它不是简单的中转代理，而是统一入口 + 智能路由 + 格式转换 + 精细计费 + 多租户管理的完整平台。一把钥匙（一个 OpenAI 兼容的 API Key），调用全球 30+ 服务商、100+ 模型，还能自动把 Claude 请求转成 OpenAI 格式、Gemini 转 OpenAI、甚至支持 OpenAI Responses / Realtime / Claude Messages / Gemini 原生格式双向转换。
官网：https://www.newapi.ai
文档：https://docs.newapi.pro
Docker 镜像：calciumion/new-api:latest
2023 年，songquanpeng 推出 One API，开源界第一款真正意义上的'OpenAI 兼容大模型聚合中转'，迅速成为自建 ChatGPT/Claude 替代方案的标配。但到 2025 年初，One API 停止维护，社区急需接棒者。
QuantumNous 团队在 2025 年 3 月左右接手 fork，命名为 New API，进行了大规模重构：
2025 年 8 月后，New API 成为主流替代，Linux.do、知乎、B 站涌现大量部署教程。2026 年 2 月最新版 v0.10.9-alpha.6 修复了状态码映射、Token 搜索、Header 透传等问题，稳定性大幅提升。
许可证：AGPL-3.0（网络服务部署必须开源）。商业闭源授权请邮件 [email protected]。
免责声明：遵守各上游服务商条款（如 OpenAI 使用政策、中国《生成式人工智能服务管理暂行办法》），项目按'AS IS'提供，无任何保证。
支持以下接口：
/v1/chat/completions（OpenAI 标准，100% 兼容 SDK）/v1/responses（OpenAI 新 Responses API，正在开发）/v1/messages（Claude 原生）/v1/gemini/...（Gemini 原生）/v1/images/generations、 /v1/audio/transcriptions、 /v1/audio/speech/v1/embeddings、 /v1/rerank（Cohere/Jina）/v1/realtime（实时对话，Azure 兼容）格式转换亮点：
gpt-5-high/medium/low、o3-mini-high、claude-3-7-sonnet-20250219-thinking、gemini-2.5-pro-thinking-128 等后缀直接生效简/繁中、英、法、日无缝切换，适合国际团队或公益站。
New API 支持几乎所有主流渠道：
渠道添加时选择对应类型（如'通义千问''Claude''自定义'），填 Base URL + Key + 模型列表即可。支持模型重定向（如上游 'qwen-plus' 映射到对外 'gpt-4o'）。
git clone https://github.com/QuantumNous/new-api.git
cd new-api
# 编辑 docker-compose.yml（设置密码、端口、Redis 等）
nano docker-compose.yml
docker compose up -d
默认 SQLite，数据在 ./data。生产建议改 MySQL/PostgreSQL + Redis。
docker pull calciumion/new-api:latest # SQLite
docker run --name new-api -d --restart always \
-p 3000:3000 \
-e TZ=Asia/Shanghai \
-v /your/data/path:/data \
calciumion/new-api:latest
# MySQL 示例
docker run --name new-api -d --restart always \
-p 3000:3000 \
-e SQL_DSN="root:yourpass@tcp(127.0.0.1:3306)/newapi?charset=utf8mb4" \
-e TZ=Asia/Shanghai \
-v /your/data:/data \
calciumion/new-api:latest
宝塔面板 ≥9.2.0 应用商店搜索 'New-API' 一键安装；1Panel 同理。
git clone ...
go build -o new-api main.go
./new-api
首次启动访问 http://your-ip:3000，默认管理员 root / 123456（立即修改！）。
Nginx 反代推荐配置（支持长连接）：
proxy_read_timeout 300s;
proxy_send_timeout 300s;
client_max_body_size 32m;
多机集群：所有实例设置相同 SESSION_SECRET + CRYPTO_SECRET + Redis，数据库共享。
关键变量（.env 或 docker-compose）：
SESSION_SECRET、CRYPTO_SECRET：必填，随机长字符串SQL_DSN：数据库连接REDIS_CONN_STRING：redis://user:pass@host:6379/0STREAMING_TIMEOUT=300MAX_REQUEST_BODY_MB=32AZURE_DEFAULT_API_VERSION=2025-04-01-previewPYROSCOPE_URL：性能监控地址ERROR_LOG_ENABLED=true完整列表见官方文档。
Python OpenAI SDK（最简单）：
from openai import OpenAI
client = OpenAI(
base_url="https://your-newapi.com/v1",
api_key="sk-你的 NewAPI 令牌"
)
response = client.chat.completions.create(
model="gpt-5-high", # 或 claude-3-7-sonnet-20250219-thinking
messages=[{"role":"user","content":"写一首诗"}],
stream=True
)
for chunk in response:
print(chunk.choices[0].delta.content or "", end="")
调用 Claude 原生：用 /v1/messages + Claude Token
调用 Gemini：/v1/gemini/...
LangChain / LlamaIndex / Dify / Open WebUI：只需把 base_url 改成 New API 地址，即可无缝使用所有模型。
Midjourney：配置 Midjourney-Proxy 渠道后，用 /mj 相关接口。
Suno：同理。
1. 智能路由优化：
2. 缓存计费：OpenAI/Azure/DeepSeek/Claude/Qwen 等支持 prompt caching，计费自动打折。
3. Realtime API：支持 OpenAI + Azure 实时语音，适合语音助手。
4. 模型广场与重定向：对外统一模型名（如 'gpt-4o' 映射多个上游）。
5. 公益站搭建：用户自助注册 + 充值 + 额度消耗，配合 Cloudflare Tunnel + Nginx + Fail2ban 防刷。
个人开发者：一台 2 核 4G 服务器 + New API + Open WebUI = 私人 ChatGPT/Claude/Gemini 超级客户端。 企业内部：多部门分组、预算分配、审计日志，合规可控。 公益站：Linux.do 社区多位大佬已部署，日活上千，结合 Cloudflare 防护。 最佳实践：
Q：One API 数据库能直接用吗？ A：完全兼容，直接替换即可。
Q：如何支持新模型？ A：自定义渠道或等待官方更新（社区 PR 很快）。
Q：Token 消耗不准？ A：检查模型定价和缓存配置。
Q：流式中断？ A：调大 STREAMING_TIMEOUT 和 Nginx timeout。
Q：AGPLv3 担心什么？ A：自用/内网无忧，SaaS 对外服务需开源或商业授权。
更多 FAQ 见官方文档。
New API 不是一个简单的中转工具，而是AI 时代的操作系统级基础设施。它让'一个 API Key，走遍 AI 世界'成为现实，让个人开发者、企业、公益站都能以最低成本、最高效率掌控自己的 AI 资产。
无论你是刚接触 AI 的新人，还是搭建千人大模型平台的架构师，New API 都值得部署。快速上手，长期受益。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online