AI 平台让人眼花撩乱，你可能通过论坛、群组获得了各种免费额度，但如果想要更灵活、更统一地管理这些模型资源，我们是否可以把它们 集合起来、统一调用，并在一个自托管平台上进行管理？

本篇文章就来介绍这款名为 New‑API 的项目。它可以帮助你从 获取模型 Token、配置系统，到部署运行与调用，一步步搭建属于自己的自托管大模型网关，实现模型资源的统一管理和高效调用。通过 New‑API，你无需为每个平台单独适配接口，也不用担心调用管理混乱，轻松实现多模型统一访问、限流控制与日志管理。如果你Token实在是多，还能选择对外运营模式，赚点小钱钱～

接下来，我们将详细介绍 New‑API 的特点、部署方法、Token 配置，以及实际调用示例，让你快速上手。

New‑API 是一个开源的大模型聚合与网关系统，本身不提供模型能力，需要使用第三方模型 API Key 才能调用模型。

它的核心功能包括：

多模型统一接口：支持 OpenAI、Claude、Gemini 等模型，提供兼容 OpenAI‑style 的 API；

集中 Token 管理：支持分组、限流、调用统计，轻松管理多模型 API Key；

自托管网关：提供用户管理、日志查看和权限控制功能；

灵活部署：支持 Docker、Docker Compose、本地部署以及多机集群模式。

简单来说，New‑API 可以把不同模型统一管理，通过一个接口进行调用，降低开发和维护成本。

部署和初始化

本文以威联通NAS为例，通过Docker Compose的方式进行部署。

虽然官方不推荐使用SQLite数据库部署，但我仍要介绍下，方便想部署试用的朋友。

services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    ports:
      - "3000:3000"      # Web 控制台，左侧建议修改
    environment:
      TZ: "Asia/Shanghai"
    volumes:
      - /share/Container/newapi:/data # 左侧目录自行更换

想要直接规模部署的朋友请参考这里：

services:
  # 数据库服务（仅内部使用，不映射端口）
  mysql:
    image: mysql:8.0
    container_name: newapi-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: newapi
      MYSQL_DATABASE: newapi
      MYSQL_USER: newapi
      MYSQL_PASSWORD: newapi
      TZ: "Asia/Shanghai"
    volumes:
      - /share/Container/new-api/mysql_data:/var/lib/mysql
    networks:
      - new-api-network

  # Redis 服务（New-API 默认依赖）
  redis:
    image: redis:latest
    container_name: newapi-redis
    restart: always
    networks:
      - new-api-network

  # New-API 服务
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    depends_on:
      - mysql
      - redis
    ports:
      - "8399:3000"   # Web 控制台端口
    environment:
      TZ: "Asia/Shanghai"
      SESSION_SECRET: "f4s9K8l3uP1qV7mZ2xR6wT0bY5nD8eH3"
      CRYPTO_SECRET: "r7M2yX9cL6vP3sT1qF8hW0zK4aB5jN6e"
      SQL_DSN: "newapi:newapi@tcp(mysql:3306)/newapi?charset=utf8mb4&parseTime=True&loc=Local"
      REDIS_CONN_STRING: "redis://redis"
      ERROR_LOG_ENABLED: "true"
      BATCH_UPDATE_ENABLED: "true"
    volumes:
      - /share/Container/new-api/data:/data
      - /share/Container/new-api/logs:/app/logs   # 保存日志
    networks:
      - new-api-network
    healthcheck:
      test: ["CMD-SHELL", "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' || exit 1"]
      interval: 30s
      timeout: 10s
      retries: 3

networks:
  new-api-network:

打开威联通的Container Station，创建新的应用程序。如果你担心数据库权限问题，可提前创建好文件夹并赋权。

等待部署完毕后，浏览器输入NAS_IP:8899即可访问界面。

首先要做的是系统初始化，如下图所示，检测到 MySQL 数据库，点击「下一步」。

设置管理员账户，点击「下一步」。

文章开头提到能赚点小钱钱就是在这里了。看大家的部署目的吧。对外运营应该最麻烦，所以我选择了他。后续可能也会深入研究一番～

不过后来发现即便选择了对外运营，控制台里也可切换自用。

点击「初始化系统」。

速度很快，啪一下就完成了。

关键配置

先通过设置的管理员账户进行登录。

很多内容都是空的，进入控制台，左侧栏有专属的管理员配置。

首先要搞定大模型，点击「渠道管理」-「添加渠道」。

支持的平台不要太多，Dify、浑元、讯飞星火、百度文心、Ollama、硅基流动等等这些都能接入进来。如果你还有第三方代理站点或者Azure的特殊接入地址，也可填写API配置。

【类型】选择你所用的AI平台。
【名称】可以自定义
【密钥】到你上面AI平台生成可调用的 API Key。
【模型】选一些新的、常用的就可，比如GLM可以选择GLM-4.7

如下图所示，填写好带红色星号的内容，就可以点击提交了。

接着点击左侧「模型管理」-「新增供应商」，填写相关信息。这部分主要是为了给你的客户看。供应商图标去那个请点击我，查找你想要的图标然后回来填写。

点击「添加模型」。

准确填写模型名称，选择匹配类型，模型图标不填写的话默认跟下面供应商的一致。

最后来到「系统设置」-「分组与模型定价设置」，对刚刚的模型定价。可以选择按量或者按次数计费。最后别忘记点击「应用更改」。

在你配置好以上部分后，便可回到「渠道管理」，进行连通性测试，如下图可看到已经成功。

其他设置我不多啰嗦。大家想要搞的话，仔细看看，配置起来都没难度。

使用调用

首先必须要讲明的是，如果反代配置了域名，对于国内的NAS、以及没有备案的VPS来说，标准端口你必定是用不成的，所以要在防护中添加你的监听端口为白名单。

接着便可以创建访问令牌了。这里我创建了一个测试账户，发了10刀。

点击「令牌管理」-「添加令牌」。

接着打开一个需要配置 URL（API 地址）和API KEY的应用。对应填写即可。

不过要注意的是 URL（API 地址）是 NAS_IP:8899/v1，如果你的 NEW API 做了反代配置域名，那也要在域名后加上v1。打开Cherry Studio，添加配置，点击绿色的管理按钮。

验证通过后，便可选择 NEW API 中配置好的模型使用了。

其次是OpenClaw，需要更改的配置内容如下，大家删除中文替换成自己的内容（删除注释），如果实在是看着感觉头皮发麻，不如把这个整个丢给你现在的虾哥，然后提供URL、KEY、模型名称，让他自动修改：

{
  "models": {
    "providers": {
      "provider名": {
        "baseUrl": "https://api.你的域名.com/v1",
        "apiKey": "你的API密钥",
        "api": "openai-completions",
        "models": [{
          "id": "模型ID",
          "name": "显示名",
          "contextWindow": 128000,
          "maxTokens": 4096
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "provider名/模型ID"
      }
    }
  }
}

必须改的只有5个地方：

provider名 → 随便起

http(s)://域名或IP/v1 → API地址

你的API密钥 → API Key

模型ID → 模型广场显示的名字

provider名/模型ID → 组合起来

最后

非常便利的项目，还能薅羊毛～用不完，根本用不完～

感谢观看，本文完。