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-api2. 启动服务
docker-compose up -d
方式二:Docker 命令
# 1. 拉取镜像
docker pull calciumion/new-api:latest2. 运行容器(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
默认管理员账号:
root123456 ⚠️ 首次登录请修改!配置使用
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 生成的令牌" \
-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 | 全平台客户端 |
接入方式:
http://你的IP:3000环境变量
常用配置项:
| 变量 | 说明 | 默认值 |
|---|---|---|
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
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。







