New API 是什么？一文看懂开源 AI 网关怎么工作
简答：New API 是一个用于统一接入和管理多家大模型服务的自托管 AI 网关，不是 GPT、Claude 或 Gemini 这类模型，也不是单独的 API 标准。它位于应用与上游模型服务之间，负责统一入口、渠道路由、API Key、权限、用量和成本管理。若你只是调用一个模型，通常不必部署；如果你要管理多个模型、多个上游 Key 或团队成员，New API 才更有价值。
定义：New API 是基于 One API 二次开发的开源 AI 网关与 AI 资产管理系统，用一个入口连接应用、Agent、团队和多个模型服务。
先用一句话判断：你需不需要 New API？
如果你的问题是“New API 是什么”，最直接的答案是：它更像 AI API 的统一接入层，而不是模型本身。应用不会直接把请求发给某一家模型服务商，而是先发送到 New API，再由 New API 根据渠道、模型、权限和路由设置转发给上游，最后把结果返回给应用。
官方文档将 New API 定义为开源 AI 网关与大模型接口管理系统，并给出了“部署实例—配置模型渠道—创建 API 令牌—开始调用”的基本路径。New API 官方文档显示，它可以通过 Docker、Docker Compose、面板或集群方式部署。
| 你的情况 | 是否适合部署 | 原因 |
|---|---|---|
| 只在一个程序里调用一家模型 | 通常不需要 | 直接使用上游 SDK 或兼容接口，组件更少。 |
| 需要统一接入多家模型 | 适合考虑 | 可以把多个渠道集中到一个入口，减少客户端改动。 |
| 团队共用模型资源 | 适合考虑 | 可以按用户、分组和 API Key 管理访问权限。 |
| 想查看用量和成本 | 适合考虑 | 控制台可用于用量日志、额度和成本管理。 |
| 只想找一个现成的 API Key | 不一定适合 | New API 本身不会自动提供上游模型额度或授权。 |
成功判定：你能明确说出至少一个上游 API Key、一个要接入的模型，以及谁需要使用这个统一入口。若这三项都没有，先不要急着部署。
New API 的完整请求链路是什么？
可以把一次调用拆成四个角色：
- 应用或客户端：例如 Dify、OpenWebUI、Cursor、Claude Code、自己的脚本或 Agent。
- New API 网关：接收统一格式的请求，检查 API Key、用户权限、分组和模型是否可用。
- 渠道与路由：根据模型映射、优先级、权重或可用状态选择上游渠道。
- 上游模型服务：真正生成文本、图片、向量或其他结果，然后由网关返回给应用。
例如，应用把 Base URL 指向 New API 的统一地址，使用 New API 签发的 Key；New API 再使用管理员配置的上游 Key 访问模型服务。这样，客户端不必保存每家上游的密钥，但网关服务器和管理员仍然需要安全保管这些凭据。
项目仓库的中文说明列出了 OpenAI Chat Completions、Responses、Anthropic Messages 和 Gemini 等协议入口，同时特别说明，实际能力取决于渠道、上游模型和转换路径，协议特有字段可能无法完整映射。New API GitHub 中文 README因此，看到“兼容某协议”时，仍应针对当前渠道和模型做一次最小请求验证。
New API 主要能做什么？
New API 的价值不在于创造新模型，而在于把模型接入、访问控制和运营管理集中起来。根据项目当前公开说明，常见能力包括：
- 统一入口：让多个应用使用同一个 Base URL，再由网关处理不同上游。
- 渠道管理：添加上游服务商、配置 API Key、模型名称、分组和可用状态。
- 模型映射：将客户端使用的模型名映射到某个渠道实际支持的模型名。
- 路由与切换：按照渠道优先级、权重或可用性分配请求；具体行为以当前版本和配置为准。
- 权限与令牌：为用户或应用创建 API Key，并限制其可访问的分组和模型。
- 用量与成本：查看请求日志、额度、订阅或成本数据，但价格和计费结果必须依据实际上游规则及你的后台配置核对。
- 协议适配：在部分场景下提供不同文本协议之间的转换，但字段、工具调用、推理内容和流式事件不一定能够完全等价转换。
这意味着 New API 更适合“管理一组模型资源”，而不是“替你购买模型”。它不会因为部署完成就自动拥有 GPT、Claude、Gemini 或其他服务的调用权限；上游账号、API Key、模型权限和服务条款仍由使用者自行负责。
New API、普通 API、中转服务和模型有什么区别？
| 名称 | 本质 | 是否提供模型本身 | 典型用途 |
|---|---|---|---|
| AI 模型 | 负责生成或处理结果的模型服务 | 是能力来源 | 文本、图像、向量、工具调用等 |
| 普通 API | 某个服务对外提供的调用接口 | 通常对应一个服务或平台 | 应用直接请求接口 |
| New API | 部署在应用与上游之间的网关和管理系统 | 不提供上游模型额度 | 统一入口、鉴权、路由、日志和成本管理 |
| 第三方 API 中转服务 | 由服务商运营的远程接入平台 | 取决于其上游授权和服务方式 | 用户直接购买或申请访问入口 |
| One API | New API 的基础项目来源之一 | 本身也不是模型 | 提供 AI 接口聚合和管理能力 |
“中转”是使用场景或运营方式，不等于某一个固定软件。自建 New API 时，网关运行在你控制的服务器上；使用远程中转服务时，服务器、渠道、日志和密钥管理则由服务运营方负责。具体服务是否可靠、合规、支持哪些模型，不能仅凭“兼容 OpenAI”几个字判断，应该核对其文档、授权范围、隐私政策、日志策略和实际响应。
New API 与 One API 是什么关系？
项目文档明确写明，New API 基于 One API 进行二次开发。可以把 One API 理解为基础项目来源，把 New API 理解为在此基础上继续增加和调整能力的项目。二者的界面、功能、协议支持、部署方式和许可证说明不能简单视为完全相同。
实际选择时，不要只比较名称。更应该检查四项：第一，当前版本是否支持你要用的协议，例如 Chat Completions、Responses 或 Anthropic Messages；第二，目标模型是否已经在渠道中正确配置；第三，是否需要团队权限、日志和成本管理；第四，许可证是否允许你的部署、SaaS、再分发或品牌使用方式。
自建 New API 需要哪些条件？
最小体验环境通常需要一台能够运行容器的服务器或本机环境、Docker、一个可用的上游 API Key、至少一个可调用模型，以及用于保存配置和日志的存储。项目 README 提供了使用 SQLite 的本地 Docker 示例，也说明 Docker Compose 配置可以组合 New API、PostgreSQL 与 Redis 等服务。仓库部署说明中还列出了数据库、缓存、会话密钥和 HTTPS Cookie 等配置项。
建议按以下顺序准备：
- 先确认服务器、域名、HTTPS 和备份方案，不要直接把管理后台暴露在没有访问控制的公网地址。
- 准备合法取得的上游 API Key，并确认它能访问目标模型。
- 选择数据库方案。个人体验可先研究 SQLite；团队或多节点部署应根据当前版本文档评估 PostgreSQL、MySQL、Redis 和日志库。
- 启动实例后完成管理员初始化，立即设置强密码、会话密钥和最小权限。
- 创建渠道，填写上游 Key、模型名和分组，并先执行渠道测试。
- 创建一个权限范围尽量小的 New API Key。
- 先请求模型列表，再发一条最小文本请求；确认返回 JSON、模型名正确且日志中没有泄露密钥。
不要把示例中的模型名、端口、数据库密码或 Base URL 原样用于生产环境。项目 README 明确提醒，部署时还应查看所选版本的发布说明，因此具体字段和能力要以当前版本文档为准。
许可证、品牌和商用部署要注意什么？
New API 项目文档说明其采用基于使用场景的双重许可：默认许可为 AGPLv3，特定商业场景或需要 AGPLv3 之外的权利时，可能需要商业许可证。文档还说明，修改后通过网络提供服务或分发修改版本时，涉及源代码提供义务；仅使用 AGPLv3 时，还需要保留项目原有品牌标识、LOGO 和版权声明。项目介绍与许可证说明中列出了这些边界。
因此，部署前至少检查：
- 你是内部自用，还是面向公众提供服务；
- 是否修改了代码、界面或品牌标识；
- 是否准备把它作为 SaaS、闭源产品或再分发软件的一部分；
- 是否需要公开修改后的源代码；
- 是否已经取得上游 API、模型和数据处理方面的授权。
这不是法律意见。若你的计划涉及商业转售、闭源集成或面向公众运营，应直接阅读当前许可证全文并咨询专业人士。项目 README 也提醒，使用者必须合法取得上游账号、Key、模型或接口权限，并遵守适用的服务条款和监管要求。
适合谁用，不适合谁用？
适合个人开发者：当你需要在多个模型之间切换、统一管理自己的 Key，或希望让多个本地工具使用同一个入口时，可以考虑部署。但要接受服务器维护、升级、备份和密钥保护的成本。
适合团队：团队需要给不同成员分配模型权限、查看用量、限制额度、统一修改上游配置时，New API 的网关和控制台价值更明显。
适合企业私有化场景：如果企业需要内部鉴权、审计日志、多渠道管理和统一接入，New API 可以作为候选方案，但应先完成安全评估、许可证审查、数据处理评估和上游授权核验。
不适合普通 API 调用者：如果你只想在一个脚本里调用一个模型，直接使用对应官方 SDK 或兼容接口通常更简单。部署网关会增加数据库、权限、日志、升级和故障排查环节。
如果你希望先使用统一的 AI API 接入方式，再根据自己的工具和模型需求选择配置，可在阅读文档后了解犀速-AI 官网提供的相关接入方案；具体模型、接口、价格和可用性以页面及实际服务说明为准。
结论：先判断管理需求，再决定是否部署
New API 的核心不是“免费获得更多模型”，而是把应用、团队、API Key、模型渠道、路由、权限、用量和成本放进一个可管理的网关中。它适合需要多模型和统一管理的人，不适合只做一次简单 API 调用的人。
最稳妥的试用路径是：阅读当前版本文档，准备合法的上游 Key，使用隔离环境部署，配置一个渠道和一个模型，创建最小权限 Key，先查询模型列表，再发送最小请求。只有确认协议、模型、日志、权限和许可证都符合需求后，再考虑公网部署或团队使用。
常见问题
New API 是免费的吗？
软件项目的默认许可和具体商业场景不是同一个问题。项目文档说明其默认采用 AGPLv3，并对特定商业场景、闭源集成、品牌移除或其他超出开源许可的需求设置商业许可要求。服务器、数据库、上游模型调用和运维成本也需要单独计算，不能简单理解为部署后所有调用免费。
New API 是不是 GPT 或 Claude？
不是。New API 是网关和管理系统，GPT、Claude、Gemini、DeepSeek 等才是模型或模型服务。New API 需要连接你已经获得授权的上游服务，不能自动提供模型额度。
New API 和 One API 有什么区别？
项目文档明确说明 New API 基于 One API 二次开发。两者可能在功能、协议、界面、部署方式、版本维护和许可证说明上存在差异，不能只按名称判断；应以各自当前仓库和文档为准。
部署 New API 后为什么调用仍然失败？
先按顺序检查：渠道是否测试通过、模型名是否与上游实际支持的名称一致、New API Key 是否有对应分组权限、Base URL 是否包含正确路径、请求协议是否与渠道支持范围一致。若返回 401、403、404 或超时，再结合实际响应和网关日志分流，不要只凭状态码猜原因。
New API 能不能直接用于 API 转售？
技术上是否能够部署，不等于法律和许可上可以直接转售。项目 README 要求使用者取得上游授权并遵守服务条款；面向公众运营还可能涉及备案、实名、日志、税务、内容安全和许可证义务，具体应按所在司法辖区和当前项目许可核验。
相关阅读
参考资料
- New API 官方文档：快速开始（docs.newapi.ai）
- New API 项目介绍与许可证说明（doc.newapi.pro）
- New API 项目公开页面（newapi.ai）