New API Windows下载
它是什么New API 是 QuantumNous 开源的自托管 AI 网关,把 OpenAI、Claude、Gemini 等模型统一接入一个入口,按应用分配密钥、限制可调模型并设置用量额度,附官方文档入口、获取步骤与常见问题解答
New API 是 QuantumNous 开源的自托管 AI 网关,把 OpenAI、Claude、Gemini 等模型统一接入一个入口,按应用分配密钥、限制可调模型并设置用量额度,附官方文档入口、获取步骤与常见问题解答。
详细介绍
简介
New API 是 QuantumNous 在 GitHub 上开源的 AI 网关项目,用于把 OpenAI、Claude、Gemini 等多家模型服务统一接入到同一个入口,再向上游应用分发密钥、限制可调用的模型范围并设置用量额度。它面向需要自托管 AI 基础设施的团队、平台运营者与个人开发者,解决多模型分散对接、密钥散落、用量与成本难以核算的问题。项目明确定位为合法且经授权的 AI API 网关,覆盖组织级认证、多模型管理、用量分析与成本统计,Windows 环境可依据官方文档在本地环境中搭建与开发,具体依赖与命令以官方页面为准。
核心功能
- 统一接入:将 OpenAI、Claude、Gemini 等模型服务聚合到一个网关入口,上游应用只需对接这一处。
- 密钥分发:为不同应用分别创建 API 密钥,各应用持有独立凭据,便于吊销与追踪。
- 模型访问限制:按应用或组织限定可调用的模型范围,避免越权调用未开放的模型。
- 用量额度控制:为应用设置调用额度,超出额度即停止服务,用于成本前置约束。
- 用量分析与成本统计:记录调用情况,输出用量分析与成本数据,支撑内部核算。
- 组织级认证:支持组织层级的身份认证与多模型管理,适合多人多部门共用一套网关。
- 自托管可控:网关部署在自己的环境中,接入哪些模型、放行哪些密钥由自己决定。
- 开源可定制:在遵守开源协议的前提下可以 fork 仓库并自行定制前端界面。
使用场景
- 团队统一出口:多个业务系统需要调用不同厂商模型时,集中经由一个网关转发,避免每处各自维护多套对接代码。
- 按项目核算成本:为每个应用单独建密钥并设置用量额度,出现超额或异常调用时可直接定位到对应应用。
- 内部多部门共享:以组织级认证管理成员访问,统一决定哪些模型对哪些应用开放。
- 本地开发与功能定制:开发者在本地环境中运行项目进行调试,官方文档专门提供了面向本地环境设置与开发的步骤。
- 界面二次开发:对默认界面不满足时,按开源协议 fork 仓库自行修改前端,再合并回自己的部署。
- 插件生态整合:GitHub 上存在基于 New-API 与 One-API 整合两者功能及第三方插件的衍生项目,可作为扩展思路参考。
安装与获取步骤
- 打开仓库 https://github.com/QuantumNous/new-api ,先读 README 与开源协议,确认用途范围与授权条件;仓库内含 VERSION 文件用于记录项目版本信息。
- 打开官方文档 https://docs.newapi.ai/ ,定位 deployment-methods 目录下的 local-development.mdx,该文档给出在本地环境中设置与开发项目的详细步骤。
- 按文档在 Windows 本地准备运行环境并获取代码,依赖项、命令与目录结构(如 Suno API 相关文档、VERSION 文件)均以文档与仓库实际内容为准。
- 完成基础配置:接入所需的模型服务,为各个应用创建密钥,逐个设置模型访问限制与用量额度,再用应用密钥发起一次调用验证链路是否打通。
- 需要定制界面时,在遵守开源协议的前提下 fork 仓库并修改前端;需要反馈问题时,先检索已有 issue 再按模板提交。
与同类方案的区别
- 与 One-API 的关系:GitHub 上有项目声明基于 New-API 和 One-API,整合了两者功能及众多第三方插件,说明 newapi 生态与 One-API 高度相关,但 New API 本身是独立的开源仓库。
- 与直接调用厂商接口的区别:直接对接需要在每个应用里保存各家凭据与格式;经网关后应用只持有自己的密钥,模型范围与额度由网关侧统一判定。
- 与 SDK 的区别:SDK 是嵌入应用的开发工具包,网关是独立部署的转发与管控服务,两者解决的问题不同,可同时使用。
注意事项
- 项目声明仅用于合法且经授权的 AI API 网关、组织级认证、多模型管理、用量分析与成本统计用途,超出授权范围的接入不被允许。
- 版本号、文件大小、校验值、发布日期等信息素材中未给出,一律以官方仓库与官方页面为准,不要采信第三方打包的分发文件。
- 提交 issue 前建议先完整阅读 https://docs.newapi.ai/ 文档与 README;issue #4773 中提交者即先确认文档与现有版本无法满足需求再描述诉求。
- 修改前端界面属于二次开发行为,须在开源协议允许的范围内进行,协议条款以仓库声明为准。
- 密钥与额度直接决定花费,创建后应按应用最小范围放行模型,并为新应用设置初始额度再逐步放开。
- Windows 本地环境与文档示例可能存在差异,遇到报错时先比对文档对应章节与已有 issue,再记录复现步骤反馈。
更新记录
最近更新:2026-10-12
软件参数速览
常见问题
Windows 上能直接下载到 New API 的现成安装包吗?
检索素材中没有给出任何 Windows 安装包、发行文件或下载地址,能否获取以官方仓库 https://github.com/QuantumNous/new-api 的 Releases 与官方页面为准,请勿使用来源不明的打包文件。
怎么确认自己用的是哪个版本?
仓库中包含 VERSION 文件,用于记录项目版本信息;同时官方文档仓库也保留了版本相关文件,具体版本号以仓库文件内容和官方页面为准。
提交 issue 之前需要准备什么?
先完整阅读 https://docs.newapi.ai/ 文档与仓库 README,确认现有版本确实无法满足需求;issue #4773 的提交者就是按此顺序操作,并已确认没有重复 issue,再按模板描述场景。
默认前端界面不符合团队风格怎么办?
项目是开源的,在遵守开源协议的前提下可以 fork 仓库并自行定制前端,这是 issue #5099 中维护方给出的处理方式。
只想在本地跑起来做开发调试,该看哪份文档?
查看 new-api-docs-v1 仓库中 deployment-methods 下的 local-development.mdx,它提供在本地环境中设置与开发项目的详细步骤,适合参与开发或做功能定制的开发者。
New API 和 One-API 是同一个项目吗?
不是。New API 是 QuantumNous 维护的独立开源仓库;GitHub 上另有项目声明基于 New-API 和 One-API 整合两者功能及众多第三方插件,属于衍生整合项目。
能不能让某个应用只能调用部分模型?
可以。官方介绍明确支持为不同应用设置密钥、模型访问限制和用量额度,按应用限定模型范围并配额即可实现。
它适合用来做什么,边界在哪里?
项目声明仅用于合法且经授权的 AI API 网关、组织级认证、多模型管理、用量分析与成本统计,超出该用途的接入不被支持。