New API 是一款基于 One API 二次开发的新一代大模型网关与人工智能资产管理系统。该项目致力于为用户提供统一且便捷的接口,用于集成和管理多种 AI 模型服务,涵盖 OpenAI、Anthropic、Midjourney 等主流平台,极大简化了资源调用的复杂度。
New API 带来了一系列增强功能与用户体验优化,具体包括:
- 全新设计的用户界面,显著提升交互流畅性与视觉体验
- 全面支持多语言,适配全球不同地区用户的使用习惯
- 集成易支付,实现在线充值功能,方便账户资金管理
- 支持通过密钥查询用量额度(需配合 neko-api-key-tool 工具)
- 完全兼容原版 One API 数据库结构,便于用户平滑迁移
- 支持按调用次数进行灵活计费
- 渠道具备权重随机分配机制,提升服务可用性
- 内置数据看板与控制台,直观呈现系统运行指标
- 提供令牌分组及模型级别权限配置,实现精细化管控
- 新增多种第三方授权登录,包括 LinuxDO、Telegram 及 OIDC 等
- 支持 Rerank 类型模型(如 Cohere 和 Jina)
- 适配 OpenAI Realtime API,同时兼容 Azure 渠道
- 支持 Claude Messages 格式调用
- 提供统一聊天界面入口(通过路由 /chat2link 访问)
- 可设置模型推理力度,借助模型名称后缀(如 -high、-medium、-low)进行调整
- 支持“思考转内容”功能
- 可对用户级别进行模型调用频率限制
- 缓存计费机制,允许自定义缓存命中时的费用比例
安装指南:使用 Docker Compose 快速部署
通过 Docker Compose 可以快速搭建 New API 服务,以下为推荐配置:
services:
new-api:
image: calciumion/new-api:latest
container_name: new-api
ports:
- 3000:3000
environment:
- TZ=Asia/Shanghai
volumes:
- /vol1/1000/docker/new-api:/data
restart: unless-stopped
使用说明
部署完成后,在浏览器中访问 http://NAS的IP:3000
即可进入 New API 管理界面。
为提升视觉体验,可切换至深色模式查看界面效果。
若选用 SQlite 作为数据库,系统将提示数据持久化相关警告,需予以关注。
请前往所映射的目录,确认数据库文件是否已正确生成。
接下来设置管理员账号与密码,建议使用强密码以提高安全性。
根据实际使用场景选择合适的系统模式,若为个人使用,建议选择“自用模式”。
确认各项设置无误后,点击“初始化系统”以完成基础配置。
初始化完成后,可见系统已集成多家国内主流大模型服务商,方便直接调用。
点击“控制台”,输入刚才设置的管理员账号及密码登录系统。
成功登录后,即可看到美观且功能清晰的管理面板,UI 体验相比原版 One API 有显著提升。
进入“渠道管理”界面,点击“添加渠道”以接入新的大模型服务。
选择所需的大模型服务提供商,并填入对应的访问密钥。
提示:一般情况下,可点击“获取模型列表”自动拉取支持的模型。如无法自动获取,也可手动选择或自定义模型名称。
保持其他设置为默认,点击“提交”完成渠道添加。
添加成功后,可点击“测试”按钮验证渠道是否正常工作。
如收到正常响应,说明该渠道已成功接入,可正式投入使用。
提示:添加多个平台账户可能耗时较长,部分服务商接入流程较为复杂,需耐心调试。
通过“操练场”功能可测试模型调用是否正常、响应是否符合预期。
在“数据看板”中可以查看详细的API调用统计与使用情况。
进入“令牌管理”,点击“添加令牌”以创建新的访问密钥。
填写令牌名称,其余可保留默认,点击“提交”生成。
生成后的密钥(API Key)将用于外部系统调用 New API 服务。
创建完成后,可通过该密钥访问 New API 提供的各类模型接口。
提示:部分集成聊天窗口的体验仍有优化空间,如在 LobeHub 中调用时可能出现兼容性问题,可尝试以下步骤继续操作。
点击界面右上角的“头像”图标。
选择“应用设置”以配置第三方访问。
进入 OpenAI 相关设置项。
在 API Key 栏中粘贴此前生成的密钥。
设置 API 代理地址,指向 New API 的 v1 接口。
提示:若 Lobe Chat 为在线版本,则需通过公网地址访问,局域网地址无法调用。可通过内网穿透服务(如节点小白)实现外网接入。
填写可在外网访问的 New API 地址。
点击“获取模型列表”,如成功显示则说明配置正确。
启用所需模型,并进行连通性测试。
理论上应顺利通过,如持续异常可检查网络或密钥权限。
如对话功能仍不可用,需排查是否为模型兼容性或接口格式问题。
为排除接口问题,可在本地部署 Lobe Chat 进行测试。虽可能出现模型不匹配提示(如无 gpt-4.1-nano),但一般不影响正常调用。
经验证,本地部署后可正常调用模型,切换内网穿透地址后仍保持稳定。
总结
New API 作为 One API 的优化版本,在继承原有功能的基础上,显著提升了界面美观度、操作便捷性与系统功能性。其支持多语言、多模型接入、精细权限控制与实时数据监控,非常适合需统一管理多个AI接口的用户,尤其推荐已使用 One API 的用户迁移至此平台。
综合推荐指数:⭐⭐⭐⭐⭐(功能全面,体验优异)
使用体验:⭐⭐⭐⭐(界面清晰,交互流畅)
部署难度:⭐⭐(简单易上手)