QuantumNous/new-api

这是什么？

核心功能

• 01对外提供 OpenAI、Anthropic Messages 与 Gemini 兼容接口，统一调用多家上游模型
• 02支持渠道的模型映射、优先级、权重与重试，实现请求路由
• 03管理用户、分组、API 密钥与配额，并记录用量日志与成本
• 04控制台支持 OAuth/OIDC、Passkey 与双因素认证
• 05通过 JavaScript 插件扩展图片、视频等异步任务接口

适用场景

• 在团队内分享已授权的模型访问，并按用户设置配额与统计用量
• 在不逐个修改客户端配置的情况下切换上游模型服务商
• 搭建带管理控制台的私有多模型服务

快速上手

1. 1

   使用 Docker 启动本地实例（SQLite，绑定本机）

   mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest
2. 2

   打开 http://localhost:3000 并完成设置向导以创建管理员账户

3. 3

   添加带有上游 API 密钥的渠道，配置模型和价格，然后创建 New API 密钥

4. 4

   使用你的密钥列出可用模型

   curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

使用前须知

• !需要自行提供上游 API 密钥和账户，并遵守上游服务条款。
• !作为公开生成式 AI 或 API 转售服务运营会带来较大的法律、备案和合规义务。
• !采用 AGPL-3.0 许可证，属于具有网络使用源码披露要求的 Copyleft 许可证。

标签

常见问题

new-api 是什么？

自托管的 AI 网关，将多家上游模型服务统一为 OpenAI、Claude、Gemini 兼容接口，并提供路由、密钥、配额与用量统计。 New API 是一个自托管的 AI 网关，位于应用与上游模型服务之间，可接入 OpenAI、Anthropic、Google Gemini、Azure OpenAI、AWS Bedrock、Vertex AI、DeepSeek 等。客户端只需调用一套统一接口，网关负责在 OpenAI Chat/Responses、Anthropic Messages 与 Gemini 等请求格式之间转换。

new-api 可以免费使用吗？用的什么许可证？

new-api 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

new-api 还在维护吗？

活跃维护中。new-api 最近一次提交是在 2026年10月19日。

new-api 适合用来做什么？

在团队内分享已授权的模型访问，并按用户设置配额与统计用量 在不逐个修改客户端配置的情况下切换上游模型服务商 搭建带管理控制台的私有多模型服务

new-api 怎么安装和运行？

使用 Docker 启动本地实例（SQLite，绑定本机）: mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest 打开 http://localhost:3000 并完成设置向导以创建管理员账户 添加带有上游 API 密钥的渠道，配置模型和价格，然后创建 New API 密钥 使用你的密钥列出可用模型: curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

在哪里获取 new-api？

源代码和安装说明在 GitHub 上：https://github.com/QuantumNous/new-api