七千二百袋水泥
七千二百袋水泥
Published on 2025-09-21 / 1 Visits

详细教程:在NAS上部署NewAPI实现AI大模型统一管理与接口网关配置完整指南

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)进行调整
  • 支持“思考转内容”功能
  • 可对用户级别进行模型调用频率限制
  • 缓存计费机制,允许自定义缓存命中时的费用比例

Image

安装指南:使用 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 管理界面。

Image

为提升视觉体验,可切换至深色模式查看界面效果。

Image

若选用 SQlite 作为数据库,系统将提示数据持久化相关警告,需予以关注。

Image

请前往所映射的目录,确认数据库文件是否已正确生成。

Image

接下来设置管理员账号与密码,建议使用强密码以提高安全性。

Image

根据实际使用场景选择合适的系统模式,若为个人使用,建议选择“自用模式”。

Image

确认各项设置无误后,点击“初始化系统”以完成基础配置。

Image

初始化完成后,可见系统已集成多家国内主流大模型服务商,方便直接调用。

Image

点击“控制台”,输入刚才设置的管理员账号及密码登录系统。

Image

成功登录后,即可看到美观且功能清晰的管理面板,UI 体验相比原版 One API 有显著提升。

Image

进入“渠道管理”界面,点击“添加渠道”以接入新的大模型服务。

Image

选择所需的大模型服务提供商,并填入对应的访问密钥。

Image

提示:一般情况下,可点击“获取模型列表”自动拉取支持的模型。如无法自动获取,也可手动选择或自定义模型名称。

Image

保持其他设置为默认,点击“提交”完成渠道添加。

Image

添加成功后,可点击“测试”按钮验证渠道是否正常工作。

Image

如收到正常响应,说明该渠道已成功接入,可正式投入使用。

Image

提示:添加多个平台账户可能耗时较长,部分服务商接入流程较为复杂,需耐心调试。

Image

通过“操练场”功能可测试模型调用是否正常、响应是否符合预期。

Image

在“数据看板”中可以查看详细的API调用统计与使用情况。

Image

进入“令牌管理”,点击“添加令牌”以创建新的访问密钥。

Image

填写令牌名称,其余可保留默认,点击“提交”生成。

Image

生成后的密钥(API Key)将用于外部系统调用 New API 服务。

Image

创建完成后,可通过该密钥访问 New API 提供的各类模型接口。

Image

提示:部分集成聊天窗口的体验仍有优化空间,如在 LobeHub 中调用时可能出现兼容性问题,可尝试以下步骤继续操作。

点击界面右上角的“头像”图标。

Image

选择“应用设置”以配置第三方访问。

Image

进入 OpenAI 相关设置项。

Image

在 API Key 栏中粘贴此前生成的密钥。

Image

设置 API 代理地址,指向 New API 的 v1 接口。

Image

提示:若 Lobe Chat 为在线版本,则需通过公网地址访问,局域网地址无法调用。可通过内网穿透服务(如节点小白)实现外网接入。

Image

填写可在外网访问的 New API 地址。

Image

点击“获取模型列表”,如成功显示则说明配置正确。

Image

启用所需模型,并进行连通性测试。

Image

理论上应顺利通过,如持续异常可检查网络或密钥权限。

Image

如对话功能仍不可用,需排查是否为模型兼容性或接口格式问题。

Image

为排除接口问题,可在本地部署 Lobe Chat 进行测试。虽可能出现模型不匹配提示(如无 gpt-4.1-nano),但一般不影响正常调用。

Image

经验证,本地部署后可正常调用模型,切换内网穿透地址后仍保持稳定。

Image

总结

New API 作为 One API 的优化版本,在继承原有功能的基础上,显著提升了界面美观度、操作便捷性与系统功能性。其支持多语言、多模型接入、精细权限控制与实时数据监控,非常适合需统一管理多个AI接口的用户,尤其推荐已使用 One API 的用户迁移至此平台。

综合推荐指数:⭐⭐⭐⭐⭐(功能全面,体验优异)
使用体验:⭐⭐⭐⭐(界面清晰,交互流畅)
部署难度:⭐⭐(简单易上手)