新一代大模型网关与AI资产管理系统：New API 全攻略

小菜猴

1163人浏览 · 2026-03-12 10:23:13

小菜猴 · 2026-03-12 10:23:13 发布

新一代大模型网关与AI资产管理系统：New API 全攻略

在AI应用开发与管理的过程中，开发者常常面临多模型适配、接口格式不统一、权限管控复杂、计费统计繁琐等问题。New API 作为新一代大模型网关与AI资产管理系统，完美解决了这些痛点，为个人开发者和企业团队提供了一站式的AI资产管控方案。本文将从New API的核心作用、部署方法到基础使用，全方位带你玩转这款工具。

一、New API 核心作用：一站式管控AI资产

New API 基于 One API 二次开发，在保留核心能力的基础上做了大量升级，其核心价值集中在以下几个方面：

1. 多模型与多接口兼容，打破格式壁垒

New API 几乎兼容主流AI模型的接口协议，包括 OpenAI-Compatible、Claude Messages、Google Gemini、Midjourney-Proxy、Suno-API 等，还支持 Rerank 重排序模型、实时对话（Realtime）等高级接口。更重要的是，它内置了接口格式转换能力，比如实现 OpenAI 与 Claude 格式互转、OpenAI 与 Gemini 格式互转，让开发者无需适配不同厂商的接口规范，大幅降低开发成本。

2. 精细化权限与计费管理

权限管控：支持令牌分组、模型访问限制、多用户管理，可按需分配不同权限，满足团队协作或多租户场景需求；
计费体系：支持在线充值（易支付、Stripe）、按调用次数计费，还适配 OpenAI、Azure、DeepSeek 等主流模型的缓存计费，支持灵活的计费策略配置，方便商业化运营或内部成本核算。

3. 智能路由与高可用保障

提供渠道加权随机、失败自动重试、用户级别模型限流等能力，可根据渠道可用性、成本等因素智能分发请求，减少接口调用失败率；同时支持流式超时配置、超大请求体限制等，保障服务稳定性。

4. 可视化与易用性升级

拥有现代化UI界面、多语言支持（中/英/法/日）、数据看板可视化统计，且完全兼容原版 One API 数据库，迁移成本极低；还支持 Discord、Telegram、OIDC 等多种授权登录方式，提升使用体验。

二、New API 部署教程：快速上手

New API 部署方式灵活，推荐使用 Docker Compose（适合新手），也支持 Docker 命令、宝塔面板等方式。我这里使用的是雨云云服务器，新用户可以用积分免费兑换云服务器，作为个人开发者练练手足够啦！雨云专属注册通道
以下是详细步骤：

部署前置要求

数据库：本地可使用 SQLite（Docker 部署需挂载数据目录），远程可使用 MySQL ≥ 5.7.8 或 PostgreSQL ≥ 9.6；
容器引擎：Docker / Docker Compose（推荐）。

方式1：Docker Compose（推荐）

克隆项目代码

# 克隆仓库
git clone https://github.com/QuantumNous/new-api.git
cd new-api

编辑配置文件（可选）
如需自定义数据库、端口等配置，可编辑 docker-compose.yml 文件，比如修改端口、配置 MySQL 连接等：

nano docker-compose.yml

启动服务

# 后台启动服务
docker-compose up -d

方式2：Docker 命令部署

（1）使用 SQLite（默认，适合快速测试）

# 拉取最新镜像
docker pull calciumion/new-api:latest

# 启动容器（挂载数据目录，保存配置和数据库）
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

（2）使用 MySQL（适合生产环境）

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="root:你的数据库密码@tcp(数据库地址:3306)/oneapi" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

💡 提示：-v ./data:/data 会将数据保存在当前目录的 data 文件夹，也可改为绝对路径（如 -v /usr/local/new-api/data:/data），避免数据丢失。

方式3：宝塔面板部署（适合新手）

安装宝塔面板（需 ≥ 9.2.0 版本）；
在宝塔应用商店搜索「New-API」；
点击「一键安装」，按提示完成配置即可。

部署验证

部署完成后，访问 http://服务器IP:3000 即可进入 New API 管理界面，默认无需登录即可进入配置页（生产环境建议尽快设置管理员账号）。

多机部署注意事项（重要）

如果需要多台服务器部署 New API，需注意：

必须设置 SESSION_SECRET 环境变量，否则多机登录状态不一致；
若使用公用 Redis，需设置 CRYPTO_SECRET 加密密钥，否则数据无法解密。

三、New API 基础使用指南

1. 核心配置步骤

（1）添加渠道（对接AI模型服务商）

进入管理后台 → 渠道管理 → 添加渠道，选择对应的模型类型（如 OpenAI、Claude、Gemini 等），填写服务商 API 密钥、接口地址等信息，测试连通性后保存。

（2）配置令牌（用于接口调用）

进入令牌管理 → 创建令牌，可设置令牌的可用模型、调用限额、有效期等，生成的令牌将作为调用接口的凭证。

（3）接口调用示例

以 OpenAI 兼容接口为例，调用地址为 http://服务器IP:3000/v1/chat/completions，请求头携带 Authorization: Bearer 你的令牌，请求体格式与 OpenAI 一致：

curl http://服务器IP:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "你好"}]
  }'