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 生成的令牌" \
      -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

    发表回复

    后才能评论