New API Win10下载
它是什么New API 是开源的 AI API 网关项目,可把多家大模型供应商接口统一成一套调用方式,覆盖组织内部鉴权、多模型管理、用量统计与成本核算。
New API 是开源的 AI API 网关项目,可把多家大模型供应商接口统一成一套调用方式,覆盖组织内部鉴权、多模型管理、用量统计与成本核算。本页整理其在 Windows 10 上通过 Docker 拉取 calciumion/new-api 镜像、映射 3000 端口的部署步骤、适用人群与合规边界。
详细介绍
简介
New API 是一个开源的 AI API 网关项目,面向合法授权的 AI API 网关、组织内部鉴权、多模型管理、用量统计、成本核算和私有化部署场景。在 Windows 10 上用 Docker 跑起官方镜像后,它能把多家大模型供应商的接口统一成一套调用方式,下游软件不必再为每个模型单独改写鉴权与请求逻辑。它适合有部署维护能力、希望自主管理网关的团队与个人开发者,核心优势是渠道集中管理、调用可统计、数据留在自己的环境里。
核心功能
- 多模型聚合:支持 OpenAI、Claude、Gemini 等多家大模型供应商的接口格式,通过一个入口对外提供统一的调用方式。
- 渠道管理:为每个上游渠道单独配置密钥与可用模型,某个渠道不可用时可切换渠道,而不必改动下游代码。
- 组织内部鉴权:面向组织内部鉴权场景,为不同下游软件分别签发访问凭证,统一收口调用权限。
- 用量统计与成本核算:按渠道与令牌记录调用情况,支撑用量统计和成本核算,缓解月底多平台分散对账的问题。
- 私有化部署:以 Docker 镜像 calciumion/new-api:latest 运行,服务与数据留在自己掌控的环境中。
- 可参与开发:项目仓库为 github.com/QuantumNous/new-api,官方文档提供本地开发部署步骤,便于做功能定制。
使用场景
- 项目里同时调用多家模型 API、写了多套鉴权与请求逻辑,希望用一个网关统一入口与凭证分发。
- 团队要切换或新增模型时,只需在网关侧调整渠道配置,下游业务代码不必跟着改写并重新部署。
- 在 NAS 或家用服务器上自建统一接口,例如在飞牛NAS 上部署 New API 并映射端口 3000,供内网客户端订阅与调用。
- 需要按团队或项目统计调用量、做成本核算的组织内部管理场景。
- 与 Open WebUI 等前端组合,搭建自有聊天平台的后端接口层,由网关统一转发到上游模型。
安装与获取步骤
- 准备 Docker 环境:先确认本机 Docker 可以正常拉取与运行容器,可参考腾讯云教程《轻量AI接口网关一键部署|calciumion/new-api Windows/Linux Docker 部署全教程》中的环境准备部分。
- 拉取镜像:在命令行执行 docker pull calciumion/new-api:latest,等待镜像下载完成。
- 启动容器并映射端口:运行容器时把宿主机 3000 端口映射到容器 3000 端口(3000:3000),这是面板的默认访问端口。
- 配置数据库:首次启动时选择数据库,Windows 10 上的部署示例为快速测试选择了 SQLite;正式环境的数据库选型以官方文档为准。
- 初始化面板:浏览器访问本机 3000 端口进入面板,添加上游渠道与模型,再为下游软件签发访问凭证。
- 需要二次开发时,克隆 github.com/QuantumNous/new-api 仓库,并按 docs.newapi.ai/zh/docs/installation/deployment-methods/local-development 准备本地开发环境。
与同类方案的区别
CLIProxyAPI、New API、Sub2API 的对比分析认为三者不是严格的替代关系:CLIProxyAPI 偏接入层,更像把 CLI/OAuth 订阅转成标准 API 的协议桥接器;New API 偏网关管理层,定位是面向团队和企业的通用 LLM 网关与资产管理平台;Sub2API 偏运营分发层。与 1Panel AI 网关相比,公开对比报告把前者归为企业级 AI 治理网关、New API 归为开源模型聚合网关。与 QuickRouter 的对比结论是:New API 更适合有部署维护能力、希望自主管理网关的团队,QuickRouter 更适合希望快速接入、减少维护成本的开发者。与 One API 及全自建方案的选型讨论,也多围绕统一鉴权、渠道故障降级和对账分散这些实际问题展开。
注意事项
- 合规边界:项目 README 明确仅面向合法授权场景,使用者必须合法取得上游 API Key、账号、模型服务或接口权限。
- 端口冲突:3000 端口被其他程序占用时,改用其他宿主机端口做映射,并同步修改下游软件里的调用地址。
- 数据库选择:示例中的 SQLite 用于快速测试,正式环境的数据库类型、备份与持久化策略以官方文档为准。
- 镜像与参数:镜像标签、端口、数据库等具体参数以官方页面与仓库 README 为准,本文不给出版本号与文件校验值。
- 选型前提:若团队没有持续维护网关的能力,需权衡自建带来的维护成本,再决定是否采用本方案。
更新记录
最近更新:2026-10-12
软件参数速览
常见问题
Windows 10 上跑 New API 之前要先准备什么?
先确认本机 Docker 环境可用,再执行 docker pull calciumion/new-api:latest 拉取镜像。若 Docker 尚未就绪,可按腾讯云《轻量AI接口网关一键部署》教程完成环境准备后继续,具体环境要求以官方文档为准。
容器启动后浏览器打不开 3000 端口怎么办?
先检查运行命令是否包含 3000:3000 的端口映射,以及容器是否处于运行状态。若宿主机 3000 已被占用,改为其他端口映射,并同步更新下游软件中的调用地址。
数据库应该选 SQLite 还是其他?
Windows 10 部署示例为快速测试选择了 SQLite。若用于正式的用量统计与成本核算,对持久化和备份要求更高,可选数据库类型与配置方式以 docs.newapi.ai 官方文档为准。
New API 和 CLIProxyAPI、Sub2API 是替代关系吗?
不是。对比分析认为 CLIProxyAPI 偏接入层,做订阅到标准 API 的协议桥接;New API 偏网关管理层;Sub2API 偏运营分发层,三者更接近不同层级的产品。
已经在用 One API,为什么还要考虑 New API?
选型讨论里常见的痛点是多套鉴权与请求逻辑、换模型要改代码重新部署、渠道故障导致降级、月底分散对账。New API 定位为面向团队和企业的通用 LLM 网关与资产管理平台,用统一网关收敛这些问题。
想尽快上线、不想长期维护,选 New API 还是 QuickRouter?
对比结论是:New API 更适合有部署维护能力、希望自主管理网关的团队;QuickRouter 更适合希望快速接入、多模型统一调用、减少维护成本的开发者,需要尽快上线的项目可据此取舍。
下游软件具体怎么接入这个网关?
在面板中配置好上游渠道与模型后,为下游软件签发访问凭证,网关通过映射的 3000 端口对外提供服务,下游按统一格式调用即可,不必为每个模型单独实现鉴权与请求逻辑。
想参与开发或做功能定制,从哪里开始?
克隆 github.com/QuantumNous/new-api 仓库,按 docs.newapi.ai/zh/docs/installation/deployment-methods/local-development 的本地开发部署文档准备环境。README 说明项目仅面向合法授权场景,动手前请先阅读项目说明。