New API 自托管指南：新一代 LLM 网关，多格式 API 聚合与精细计费管理！

已经在用 One API 管理团队的 AI 接口，但面对 Claude 的 Thinking 模式、OpenAI 的 o3 推理模型、Gemini 的长上下文，格式转换和计费统计越来越跟不上？New API 是 One API 的社区增强版，数据库完全兼容，重点补了新一代模型需要的那部分。

什么是 New API？

New API 是一款开源的新一代 LLM 网关与 AI 资产管理系统，基于 One API 开发，完整兼容 One API 数据库，重点强化了多格式 API 转换、推理模型支持、可视化计费统计和企业级认证集成。

• 协议：MIT License

• 仓库：github.com/Calcium-Ion/new-api

与 One API 的区别

核心功能

• 统一 API 网关：以 OpenAI 格式统一代理 OpenAI、Azure、Claude、Gemini、DeepSeek、Qwen、Cohere、Midjourney 等上游服务，调用方无需适配各家接口差异。

• Token 与配额管理：为用户或应用生成独立 Token，设置过期时间、用量上限、模型访问白名单。

• 智能路由：多渠道加权随机选择，自动重试失败请求，支持用户级请求频率限制。

• 计费与结算：内置计费系统，支持 Stripe 和 EPay 在线支付，可为不同用户组配置差异化定价。

可以解决什么问题

• 企业 AI 接口统一管理：集中管理多家厂商的 API Key，按部门分配配额，统计实际用量与成本。

• 格式兼容适配：现有系统基于 OpenAI SDK 开发但需要调用 Claude 或 Gemini，通过 New API 的格式转换，调用方代码不用改。

• 推理模型统一入口：把 o3、Claude Thinking、Gemini Thinking 等推理模型收归到统一网关管理，配置推理力度，控制 Token 消耗。

• 对外分发与计费：向用户提供 AI API 订阅服务，New API 负责计量和结算，对接 Stripe 完成支付。

使用 Docker Compose 部署

创建 docker-compose.yml 并写入以下内容：

services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

如需使用 MySQL 替代默认的 SQLite 数据库：

services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=user:password@tcp(mysql:3306)/newapi
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: new-api-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=newapi
      - MYSQL_USER=user
      - MYSQL_PASSWORD=password
    volumes:
      - ./mysqldata:/var/lib/mysql
    restart: unless-stopped

执行 docker compose up -d 启动后，访问 http://<server-ip>:3000，使用默认账号 root 登录。

注意：默认 root 密码为 123456，首次登录后请立即修改。

在 1Panel 上的一键部署

1Panel 应用商店已上架 New API。进入应用商店搜索 "New API"，点击安装，配置端口和数据目录后提交。从 One API 迁移过来的话，数据库直接兼容，不需要重新导入数据。

👇 1Panel 官方地址

安装 1Panel

以 root 用户身份运行以下一键安装脚本，自动完成 1Panel 的下载和安装：

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

📖 详细安装说明：请参考 1Panel 官方安装文档

安装 New API

登录 1Panel，进入应用商店，搜索 New API，点击安装，配置访问端口（默认 3000）和数据挂载路径，勾选端口外部访问后提交即可。

安装完成后在已安装页面点击跳转，使用 root / 123456 登录，立即修改默认密码，然后在渠道管理中添加上游 API Key。

参考链接

• GitHub · Calcium-Ion/new-api