New API 是一个自托管的 AI 网关—— 项目 QuantumNous/new-api，社区 48,520 star。它把不同厂商的模型服务接进同一个入口，让你用同一套控制台管理渠道、访问权限、用量与成本。

为什么需要它？你手上的 API Key 越来越多：OpenAI 一把、Claude 一把、Gemini 一把、DeepSeek 一把，散落在 Cursor、Cherry Studio 和各种脚本里。换一次模型，要挨个客户端重新配；这个月花了多少钱、哪个模型用得最多，也说不清。New API 就是在你和所有上游之间加一层：上游都接进它，客户端只认它。

怎么用（三步）

• ① 起服务：一条 Docker 命令跑起单实例，数据存在自己硬盘的 data 目录；打开 http://localhost:3000 按向导创建管理员账号。
• ② 接上游：控制台「新建渠道」，填上游 API Key、可用模型与分组，跑一次渠道测试；再配好模型价格。
• ③ 发 Key 并接客户端：生成一把 API Key（可限定分组与模型），把客户端的 Base URL 改成 http://你的地址:3000/v1，密钥填这把 Key 即可。

好在哪

• 换模型不改代码：客户端永远只认一个 Base URL 和一把 Key，上游换厂商、换型号都不用动客户端。
• 协议互通：OpenAI Chat Completions / OpenAI Responses / Anthropic Messages / Gemini 四种协议互转，本来只认 OpenAI 格式的客户端也能直接调 Claude 和 Gemini。
• 渠道调度：模型映射、优先级与权重、失败重试、渠道亲和、多密钥管理——一个渠道抖了自动走下一个。
• 成本看得见：额度、订阅套餐、用量日志、缓存计费，以及基于表达式的阶梯定价。
• 权限管得住：用户、分组、细粒度权限、API Key 限额，支持 OAuth/OIDC、通行密钥、两步验证。
• 数据在自己手里：自托管，Key 和调用日志都不出自己的机器。

部署建议：正式环境用 docker compose（默认 New API + PostgreSQL + Redis），主库可选 SQLite / MySQL / PostgreSQL，日志库可单独接 ClickHouse；HTTPS 部署时记得设 SESSION_COOKIE_SECURE=true。

版本：v1.0.0-rc.39（Go + Gin，控制台 React 19 + TypeScript，AGPL-3.0 ）。请仅用于合法授权的 API 网关、内部鉴权、多模型管理与私有化部署场景，须合法取得上游 API Key 并遵守上游服务条款与当地法规。