一、开源项目 New API

New API 是一个统一的 LLM 网关平台，将多个 AI 服务商的接口聚合为标准的 OpenAI 兼容 API，让你通过一个地址访问数十种模型。

New API 是新一代 AI 基座平台，为您的 AI 应用提供统一的基础设施。承载所有 AI 应用，管理您的数字资产，连接未来的统一接口平台。

New API 无缝集成全球主流 AI 服务提供商，包括 OpenAI、Anthropic、Google Gemini、DeepSeek、Midjourney、Suno 等 30+ 模型服务。

1.1 Star History

29.6 k

1.2 核心特性

统一接口：一个 API 端点接入所有 AI 服务，兼容 OpenAI 标准格式

智能路由：多渠道负载均衡、故障自动切换、加权随机分发

精细计费：支持按次数/按量计费、预付费充值、多倍率配置

安全管控：令牌权限管理、模型访问控制、API 调用审计

数据洞察：实时数据看板、用量统计、成本分析

多租户架构：完美适配个人开发者、团队协作与企业级部署

1.3 许可证

New API 采用 GNU AGPLv3 开源协议，只要遵守开源协议即可免费使用。

二、快速安装部署

本文我们通过 1Panel 面板部署 New API

2.1 前置环境要求

推荐系统 Linux (Ubuntu/CentOS/Debian 等)

服务器配置 至少 2 核 4G 内存

2.2 安装部署

步骤一：完成 1Panel 面板的安装部署

参见官网的1Panel 安装部署手册，执行安装命令完成安装

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

安装完成 1Panel 面板后进入面板设置完成访问 IP 设置，方便后续应用快速跳转。

步骤二：进入应用商店安装 NewAPI

进入 1Panel 应用商店搜索 NewAPI 并点击安装

步骤三：安装配置参数设置

基于安装页面输入相关参数，具体参数设置参见如下：

名称：自定义应用名称，默认为new-api

版本：选择最新的 new-api 版本，默认为最新的 new-api 版本；

端口：输入防火墙或者安全组对应已开通的端口，默认端口为3000；

时区：根据实际时区选择即可；

容器名称：默认为空即可；

端口外部访问：如果选择外部访问，需要勾选；

其它：其它相关参数保持默认即可。

三、平台角色说明

根据账号权限，平台分为三种角色，各自拥有不同的功能范围。

• 普通用户：注册后的默认角色，可以创建令牌、调用 API、查看个人用量、充值与订阅。

• 管理员（Admin）：由 Root 提升的管理角色，在用户权限基础上，可以管理渠道、用户、兑换码、日志、模型与分组。

• 超级管理员（Root）：最高权限角色，在管理员基础上，额外拥有系统全局设置、自定义 OAuth、性能监控等能力。

四、平台功能介绍

4.1 个人设置

进入个人设置完成个人账号管理以及令牌管理，其中令牌管理支持创建管理API调用凭证，完成令牌权限、配额限制、模型限制以及 IP 白名单等设置。

4.2 系统设置

系统设置主要完成模型分组定价、系统 API 调用信息设置等，其中使用 API 需要在系统设置中完成 API 接口的访问 URL 配置，参见如下图所示：

配置完成后，即可点击左上角 New API 的 logo 进入首页查看可访问的 API

其中支持的端点接口参见如下清单：

4.3 渠道管理

通过渠道管理可以增加各个模型供应商，如下图所示，点击添加渠道完成添加。

添加渠道时输入渠道名称、密钥、API 地址，并选择已有模型/自定义模型填入即可。

配置项说明：

Base URL：自定义接口地址,代理或私有部署时使用，其中BaseURL后面不要增加 V1 以及 /

优先级：数值越高越优先被选中,默认为 0

权重：同优先级下的随机权重,默认为 0

模型映射：将用户请求的模型名映射为实际模型名,JSON 格式

参数覆盖：强制覆盖请求中的某些参数,JSON 格式

自动禁用：开启后连续失败达到阈值时自动禁用该渠道

4.4 价格设置以及测试验证

基于以上步骤添加完模型后，进入系统设置完成模型单价添加以及计费方式设置。

模型单价设置时需要手动先添加渠道中包含的模型，如下图所示：

设置完成计费规则后，进入渠道管理完成模型测试验证，如下图所示：

测试成功后进入操练场，完成模型对话验证，如下图所示：

1、确定渠道所在的分组；

2、选择该分组的模型；

3、确定相关参数，一般可以保持默认；

4、输入信息，等待模型反馈；

5、模型正常输出即代表模型配置完成。

4.5 模型配置（对应模型广场功能）

五、对接 OpenClaw

基于 1Panel 完成 OpenClaw 创建，然后基于 AI 的模型账号管理，添加管理 New API 模型账号，具体参件如下图所示：

以上配置信息具体填写参见如下，输入完成后点击保存按钮即可。

1、模型供应商：选择自定义

2、API Key：进入 New API 获取个人令牌；

3、Base URL：进入首页获取API调用接口增加 /v1

4、API 类型：选择 openai-completions

添加完以上供应商后，进入模型池页面，逐项将NewAPI中已经添加好的模型添加即可，如下所示：

最后基于 1Panel 将 OpenClaw 的模型账号切换为 New API，如下图所示：

设置完成后，我们进入 OpenClaw 页面，就可以随意切换我们自己的 “Token Plan” 啦！

六、总结

以上完成配置后，我们发现我们通过 New API 可以构建一个专属自己团队或者个人的 Token Plan：

6.1 LLM 聚合统一管理

• 一站式聚合多模型：无缝接入DeepSeek、豆包、阿里云百炼、 OpenAI、Anthropic、Gemini、Midjourney、Suno 以及本地模型等 30 + 主流 AI 服务商，一个平台聚合所有大模型。

• 统一标准接口：所有模型统一转为OpenAI 兼容 API 格式，只用一个接口地址即可调用数十种模型，不用适配各家不同接口。

6.2 调度与运维能力

1. 智能路由调度：支持负载均衡、故障自动切换、加权随机分发，稳定性更高，避免单点服务故障。

2. 灵活渠道配置：可自定义 Base URL、优先级、权重、模型映射、参数覆盖，支持代理 / 私有部署场景；连续失败可自动禁用渠道，省心运维。

6.3 计费与权限管理

1. 精细化计费管控：支持按次数 / 按量计费、预付费充值、多倍率定价，可独立做成本核算。

2. 完善安全权限：拥有令牌管理、模型访问控制、API 调用审计、IP 白名单、配额限额管控，安全可控。

3. 多租户架构：适配个人、团队、企业级使用，支持多用户 / 多部门独立注册、专人专用、单独计量计费和配额限制。

6.4 数据与管理能力

1. 数据可视化洞察：自带实时数据看板、用量统计、成本分析，清晰掌握模型调用消耗与使用情况。

2. 分层角色权限：普通用户、管理员、超级管理员三级权限，权责划分清晰，适配企业团队管理。

6.5 部署与适配便捷

1. 部署简单：可通过 1Panel 应用商店一键安装，低配服务器（2 核 4G）即可部署，上手门槛低。

2. 完美对接下游：可无缝对接 OpenClaw 等 AI 基座平台，统一纳入模型池，自由切换调度自有 Token Plan、Coding Plan、本地模型。

6.6 业务与价值优势

1. 自建私有大模型网关：打造个人 / 团队 / 企业专属 AI 模型管理平台，不用依赖第三方中转。

2. 灵活选型赋能应用：搭建 AI 助理、开发 AI 应用时，可随意切换适配最优大模型，调用更灵活。

3. 开源免费合规：采用 GNU AGPLv3 开源协议，遵守协议即可免费商用和自用。

七、注意事项

注意事项1：个人令牌中有模型限制以及对应的渠道供应商、额度、IP白名单设置，确保你的个人令牌可用：

注意事项2：模型渠道有分组，在测试以及API调用时确保你 API 对应的模型分组匹配都正确

注意事项3：渠道供应商输入时不需要 /v1 的标记，切记输入的 Base URL 地址都正确