New API - 新一代AI大模型网关搭建教程

New API - 新一代AI大模型网关搭建教程

新一代大模型网关与AI资产管理系统，支持中文界面，易于部署

项目简介

New API 是一个功能强大的 AI Gateway 开源项目：

• ⭐ 18,380+ Stars GitHub热门项目
• 🇨🇳 原生中文界面 完整支持
• 🐳 Docker 部署 简单快捷
• 💰 内置计费系统 支持充值和渠道管理
• 🔄 多平台兼容 OpenAI/Claude/Gemini/DeepSeek

功能特性

功能	说明
🎨 全新UI	现代化Web界面
🌍 多语言	中文/英文/法语/日语
📈 数据看板	可视化统计分析
🔒 权限管理	令牌分组/模型限制
💳 支付充值	支持易支付/Stripe
🔄 格式转换	OpenAI/Claude/Gemini互转
⚖️ 智能路由	渠道加权/失败重试

快速开始

方式一：Docker Compose（推荐）

# 1. 克隆项目
git clone https://github.com/QuantumNous/new-api.git
cd new-api

# 2. 启动服务
docker-compose up -d

方式二：Docker 命令

# 1. 拉取镜像
docker pull calciumion/new-api:latest

# 2. 运行容器（SQLite版）
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

3. 访问后台

部署完成后打开浏览器访问：

http://你的服务器IP:3000

默认管理员账号：

• 用户名：root
• 密码：123456 ⚠️ 首次登录请修改！

配置使用

1. 添加AI渠道

登录后台后，依次点击：

渠道管理 → 添加渠道

填写配置：

字段	说明	示例
API Key	供应商的密钥	sk-xxx
模型	使用的模型	gpt-4o / claude-3-5-sonnet
名称	渠道备注	我的OpenAI

2. 创建令牌

令牌管理 → 创建令牌

• 设置令牌名称
• 设置额度（可选）
• 复制生成的Key

3. 使用API

获取到的 Key 可以用于任何兼容 OpenAI API 的客户端：

curl -X POST http://你的服务器:3000/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

接入客户端

New API 兼容以下客户端：

客户端	说明
Cherry Studio	桌面AI助手
Next Chat	ChatGPT Web版
Lobe Chat	现代AI聊天框架
Anything	全平台客户端

接入方式：

• API 地址：http://你的IP:3000
• API Key：后台创建的令牌

环境变量

常用配置项：

变量	说明	默认值
TZ	时区	Asia/Shanghai
LOG_LEVEL	日志级别	info
DEFAULT_TOKEN	默认令牌额度	无限制

常见问题

1. 无法访问后台？

# 检查容器状态
docker ps

# 查看日志
docker logs new-api

# 检查端口
netstat -tlnp | grep 3000

2. 如何更新版本？

docker-compose pull
docker-compose up -d

3. 数据在哪？

数据保存在 ./data 目录，迁移时直接复制即可。

总结

New API 是目前最适合中文用户的 AI Gateway 方案：

• ✅ 部署简单（Docker一键部署）
• ✅ 中文界面（完整汉化）
• ✅ 功能丰富（计费/路由/转换）
• ✅ 社区活跃（18k+ Stars）
• ✅ 客户端多（兼容主流AI客户端）

GitHub: https://github.com/QuantumNous/new-api
文档: https://docs.newapi.pro/zh/docs