New_API

New_API.md

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

概述

New API 是新一代 AI 基座平台,为您的 AI 应用提供统一的基础设施。承载所有 AI 应用,管理您的数字资产,连接未来的统一接口平台。

核心特性

  • 统一接口:一个 API 端点接入所有 AI 服务,兼容 OpenAI 标准格式
  • 智能路由:多渠道负载均衡、故障自动切换、加权随机分发
  • 精细计费:支持按次数/按量计费、预付费充值、多倍率配置
  • 安全管控:令牌权限管理、模型访问控制、API 调用审计
  • 数据洞察:实时数据看板、用量统计、成本分析
  • 多租户架构:完美适配个人开发者、团队协作与企业级部署

Docker 部署

  • 使用SQLite数据库(不推荐)
c 复制代码
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
  
# 示例
docker run --name new_api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /home/liutest/newapi_data:/data \
  calciumion/new-api:latest
  • 使用MySQL数据库
c 复制代码
docker pull calciumion/new-api:latest

docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="用户名:密码@tcp(数据库地址:3306)/数据库名" \
  -e TZ=Asia/Shanghai \
  -v /your/data/path:/data \
  calciumion/new-api:latest
  
# 示例
# 数据库mysql
docker run -d --restart always \
  -v /home/liutest/mysqldata/data:/var/lib/mysql \
  -v /home/liutest/mysqldata/conf:/etc/mysql/conf.d/ \
  --name mysql8.0.40 \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -p 3306:3306 \
  mysql:8.0.40
  
# new_api
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="root:123456@tcp(192.168.42.132:3306)/new_api" \
  -e TZ=Asia/Shanghai \
  -v /home/liutest/new_api_data:/data \
  calciumion/new-api:latest

使用Docker Compose部署

c 复制代码
# 下载项目源码
git clone https://github.com/QuantumNous/new-api.git

# 进入项目目录
cd new-api
# 根据需要编辑 docker-compose.yml 文件
# 使用nano编辑器

nano docker-compose.yml
# 或使用vim编辑器
# vim docker-compose.yml
c 复制代码
# 方式一:直接启动
docker compose up -d

# 方式二:指定文件启动:基本语法:-f 后跟文件路径
docker compose -f docker-compose-newapi.yml up -d
  • 删除清理步骤

如果想清理数据卸载,按如下。

c 复制代码
# 1.查看目录相关位置

/home/liutest/new_api_dir
root@liutest:/home/liutest/new_api_dir# ls -hl
total 12K
drwxr-xr-x 2 root    root    4.0K Mar 11 13:07 data
-rw-rw-r-- 1 liutest liutest 3.4K Mar 11 13:00 docker-compose.yml
drwxr-xr-x 2 root    root    4.0K Mar 11 13:07 logs

root@liutest:/home/liutest/new_api_dir# docker volume inspect new_api_dir_pg_data
[
    {
        "CreatedAt": "2026-03-11T13:07:04+08:00",
        "Driver": "local",
        "Labels": {
            "com.docker.compose.config-hash": "6706935fd23c5a605ea1fe71c28f5dec1ecf9699dbea8919848750c5366de25a",
            "com.docker.compose.project": "new_api_dir",
            "com.docker.compose.version": "5.1.0",
            "com.docker.compose.volume": "pg_data"
        },
        "Mountpoint": "/var/lib/docker/volumes/new_api_dir_pg_data/_data",
        "Name": "new_api_dir_pg_data",
        "Options": null,
        "Scope": "local"
    }
]

# 2.停止 / 重启服务

# 停止并删除容器、网络(保留数据卷/配置文件)
docker compose down

# 停止服务并删除数据卷(谨慎!会清空数据库)
docker compose down -v

# 验证数据卷是否已删除
docker volume ls | grep new_api_dir  # 无输出则说明已删除

# 重启服务
docker compose restart
c 复制代码
# 步骤 4:清理 Docker 残留资源(可选)
# 删除所有未使用的镜像、容器、网络、数据卷(谨慎!会清理所有无用资源)
docker system prune -a -f

# 单独删除 New API/PostgreSQL/MySQL/Redis 镜像(精准清理)
docker rmi calciumion/new-api:latest postgres:15 mysql:8.2 redis:latest -f

api测试

new-api支持多种协议转换,比如

c 复制代码
curl --location 'http://192.168.42.132:3000/v1/messages' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-aa2s4UWxkhoVQOtB56WBJzUGKAqEh919fHRDPhRmBOiePfng' \
--data '{
  "model": "deepseek-v3",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "java invoke http"
        }
      ]
    }
  ],
  "stream": true
}'

curl --location 'http://192.168.42.132:3000/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-aa2s4UWxkhoVQOtB56WBJzUGKAqEh919fHRDPhRmBOiePfng' \
--data '{
  "model": "deepseek-v3",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "system",
      "content": "hello"
    },
    {
      "role": "user",
      "content": "java invoke http"
    }
  ],
  "stream": true
}'
相关推荐
孟健1 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
工程小白菜4 小时前
ai-code-review 全链路:让 AI 来审 AI 的代码
ci/cd·ai编程
小虎AI生活5 小时前
8万星开源HyperFrames,我用WorkBuddy免费模型做了3条视频
aigc·ai编程
AI大模型-小华8 小时前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
huangfuyk9 小时前
前端融入/转后端避坑指南:AI 时代的安全边界、数据防线与实战细节
后端·ai编程
ZzT10 小时前
AI-SDLC 实践 06|开发阶段的知识库:Agent 写代码前该读哪些规则和业务知识
ai编程·claude
Bigger10 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程
前端双越老师11 小时前
程序员 1v1 访谈系列第十六期:裸辞后失业半年了
前端·ai编程·全栈
可夫小子12 小时前
不换大模型、关掉深度思考:Hugging Face 用一个 LoRA 把 27B 编程能力拉到 64.7%
ai编程·facebook
ZhengEnCi21 小时前
AI 读不懂你的代码怎么办:用高价值注释消除曲解、过度优化与上下文膨胀
aigc·ai编程