new-api 是 GitHub 上一个 47k stars 的开源 AI 网关项目:它能将 OpenAI、Claude、Gemini 等多家模型 API 聚合成一套统一接口,并集中处理权限、计费与用量统计。项目最新版本 v1.0.0-rc.30 于 2026 年 8 月 31 日发布,已积累 11.2k forks,采用 AGPL-3.0 协议。

解决什么问题

当团队同时接入多家大模型 API 时,接口格式不互通是主要成本:OpenAI 的 Chat Completions、Claude 的 Messages、Gemini 的生成接口各不相同。new-api 在上游模型与下游调用方之间做一层转换,把各家模型统一成 OpenAI 兼容、Claude 兼容或 Gemini 兼容的格式,调用方只需要对接一种格式。它同时支持 OpenAI Responses 与 Realtime API(含 Azure 版本),以及 Cohere、Jina 的 Rerank 模型。

与 One API 的关系

new-api 从开源项目 One API 发展而来,数据库与 One API 完全兼容,老用户可以直接迁移。代码以 Go 为主(占 75.8%),前端为 TypeScript(占 21%)。项目包含 297 位贡献者、超过 6,200 次提交,仓库仍处于高频更新状态。

管理能力:令牌、计费、登录

  • 令牌与模型管理:令牌分组、模型限制、用户管理,可按用户限制可用的模型与额度。
  • 计费与统计:按请求、按用量、按缓存命中计费,覆盖 OpenAI、Azure、DeepSeek、Claude、Qwen 等模型的缓存计费统计。
  • 登录方式:支持 Discord、LinuxDO、Telegram 授权登录与 OIDC 统一认证。
  • 推理配置:对 o3-mini、gpt-5、claude-3-7-sonnet、gemini-2.5 等推理模型可配置思考开关与 reasoning effort 档位(high / medium / low)。

部署方式

Docker Compose 或单容器均可,默认使用 SQLite,也支持 MySQL(≥ 5.7.8)或 PostgreSQL(≥ 9.6):

docker pull calciumion/new-api:latest

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

部署完成后访问 http://localhost:3000 即可开始配置渠道与令牌。多节点部署时,所有节点必须使用相同的 SESSION_SECRET,否则访问令牌与登录会话无法互相验证;共享 Redis 的节点还需一致的 CRYPTO_SECRET。

使用边界

项目声明仅用于合法授权的 API 网关场景:上游 API 密钥需依法取得并遵守上游服务条款;对外提供生成式 AI 服务时,需按所在地完成备案、许可、内容安全、实名等义务。协议为 AGPL-3.0,修改版需保留原作者署名,并在界面中保留指向原项目的链接。

结论:对需要统一管理多家模型 API 的团队,new-api 提供了一条低成本的现成路径——格式转换、权限、计费集中在一个网关内完成,Docker 单容器即可起步;选用前确认 AGPL-3.0 许可义务与上游授权范围即可。