Logo TodTom休闲时光

从零开始：用群晖 NAS 搭建 New-API 并集成智谱 AI 打造全能 AI 编程助手

前言※#

在 AI 编程工具（如 Roo Code, Cursor）百花齐放的今天，我们经常需要在多个 AI 厂商（OpenAI, Claude, 智谱, DeepSeek）之间切换。New-API 就像一个“万用转换插头”，它能把各种零散的 API 聚合在一起，提供统一的 OpenAI 格式接口，并带上详细的账单统计。

本文将以 智谱 AI 为例，手把手教你在群晖 NAS 上完成部署与深度配置。

一、 环境准备：在群晖上快速部署※#

虽然官方提供了全家桶配置，但对于个人自用，我推荐使用 SQLite 极简版，省电、省内存、易备份。

1. 创建文件夹※#

在群晖 File Station 的 docker 目录下新建 new-api 文件夹。

2. 使用 Container Manager 部署※#

打开 Container Manager，新建项目，填写以下配置：

version: '3'
services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    ports:
      - "3000:3000"  # 外部访问端口
    volumes:
      - /volume1/docker/new-api:/data # 数据库文件映射
    environment:
      - TZ=Asia/Shanghai
      - ALLOW_REGISTER=false       # 部署完后记得改为 false 禁用注册
      - BATCH_UPDATE_ENABLED=true  # 开启异步计费，提升响应速度

二、 核心配置：接入智谱 AI※#

1. 获取密钥※#

前往 智谱 AI 开放平台，在“API 密钥”页复制你的 Key。

2. 添加渠道※#

登录 New-API，创建管理员账号密码，点击 渠道 -> 添加渠道：

  • 类型：智谱 AI
  • 模型：手动填入 glm-4.7-flash（智谱最新免费模型）以及 glm-4.7 等。
  • 密钥：填入刚才复制的 Key。

三、 深度避坑：解决“倍率未配置”报错※#

当你首次在编程工具里调用新模型时，经常会遇到 403 Forbidden (倍率未配置)。这是因为 New-API 的运营模式需要你为每个模型“明码标价”。

1. 设置模型价格※#

点击 设置 -> 运营设置 -> 分组与模型定价：

  • 免费模型（如 glm-4.7-flash）：将“模型倍率”设为 0。这样你就可以在日志里看到调用记录，但不扣虚拟额度。
  • 付费模型：将“模型倍率”设为 1（简单统计）或根据官网单价折算。“补全倍率”为输出价 ÷ 输入价，一般情况输出价格会比输入价格高
  • 注意：不要填“模型固定价格”，否则会禁掉按 Token 计费的逻辑。

四、 实战：在 Roo Code 中使用※#

在你的 VS Code 插件（如 Roo Code / Cline）或其他需要调用大模型api的场景中进行如下设置：

  1. API Provider: 选择 OpenAI Compatible。
  2. Base URL: http://你的NAS内网IP:3000/v1 （切记末尾要带 /v1）。
  3. API Key: 使用在 New-API “令牌”页面生成的 sk-xxxx 密钥。
  4. Model ID: 填入你在渠道里定义的名称，如 glm-4.7-flash。

五、 总结与进阶建议※#

  • 多账号薅羊毛：
    • 你可以注册多个智谱账号，在 New-API 里配置多个渠道并开启“自动禁用”。当一个账号额度用完，系统会自动切到下一个。
    • 探索其他免费或有优惠活动的云端大模型供应商，将API聚合到New-API中
  • 价格监控：通过 New-API 的“日志”功能，你可以清晰地看到每个编程项目消耗了多少 Token，折合多少人民币。
  • 下一步计划：当国内模型满足不了复杂需求时，可以尝试接入 OpenRouter，它能让你以同样的方式调用 Claude 3.5 Sonnet 等顶级模型。