One API 与 new-api 对比

简介

One API 与 new-api 是可公开获取的项目，适用 Windows/x64。本页只列出可公开核对的内容（版本号、安装包文件信息、安装方式与常见问题）；该软件的具体功能与适用条件请以官方来源为准。

一、核心痛点与软件介绍

很多刚接触大模型应用的朋友，手上有好几个渠道的 API Key，却要一个一个写进代码，额度用超了才发现，不同渠道的模型名还各叫各的——One API 与 new-api 对比的讨论之所以一直有热度，就是因为大家都在找一个能统一收口的方案。这两款都是 GitHub 上的开源项目，本质是「AI 网关」：把多家模型服务的密钥集中托管，对外只暴露一个统一的接口，按渠道分发请求、记账、限额。适合个人开发者、小团队做内部工具，也适合需要给应用做配额管理的人。两者都支持渠道管理与令牌计费这一套核心思路，差异主要在界面细节、更新节奏与生态插件上。

二、环境要求与官方下载

两个项目都属于服务端程序，不提供 Windows 安装包或 macOS 镜像，也没有收录在本页下载区的安装文件，请前往各自项目的 GitHub 仓库（Release 页面）获取部署文件，具体以官网实际信息为准。

• 运行依赖：通常需要 Docker（或直接装 Go 环境从源码构建），以及一个数据库（SQLite / MySQL / PostgreSQL，按官方文档选择）。
• 系统要求：本站未收录精确的 CPU、内存、磁盘参数，Linux 服务器与本地开发机均可跑，具体以官网/仓库文档为准。

三、保姆级安装步骤（Docker 部署）

【步骤一：拉取镜像并启动容器】先在终端确认 Docker 已运行，再输入官方文档给出的 docker 命令（镜像名与端口映射以仓库 README 为准），回车执行；若提示拉取失败，可选择换用镜像加速地址后重试。

【步骤二：配置数据库与环境变量】在启动命令或 compose 文件里输入数据库连接串、管理后台初始管理员账号密码等关键项；这些属于配置文件/环境变量级别设置，具体键名以官方文档为准，不要凭记忆改。

【步骤三：完成初始化】容器跑起来后，浏览器打开映射的端口，首次进入向导填写管理员邮箱与密码，点击「保存/创建」完成初始化，随后在后台添加渠道与令牌即可用。

macOS 用户：本项目无 dmg 安装包，不适用「拖入 Applications」的安装方式，也无需授予屏幕录制/辅助功能权限，直接用 Docker Desktop 或 Homebrew 安装 Docker 后按上述步骤执行即可。Windows 用户同理，暂无 winget 安装包，建议在 WSL2 或 Docker Desktop 中部署。

四、首次启动快速配置

进入后台后建议先做三件事：

1. 渠道菜单：点击「添加渠道」，填入上游服务商的密钥与 Base URL，保存后用内置测试按钮验证连通性。
2. 令牌菜单：创建对外暴露的 Key，设置可用模型白名单与额度上限。
3. 系统设置：调整默认限额、日志保留天数等基础参数，具体选项名以当前版本界面为准。

五、常见安装报错解决方案（FAQ）

症状一：容器启动后立刻退出，日志显示数据库连接失败。解决：检查环境变量里的数据库地址、端口、账号密码是否填对；用 SQLite 时确认挂载目录有写权限。

症状二：浏览器能打开页面但接口全部 401。解决：确认请求用的是「令牌」菜单里创建的 Key，而不是渠道的上游密钥；同时检查令牌所属分组是否有该模型权限。

症状三：拉取镜像超时或速度极慢。解决：为 Docker 配置镜像加速器后重启 Docker 服务，或改用源码构建方式部署。

六、优缺点

优点

• 开源免费，代码与 Issues 公开可查，可自行审计与二次开发。
• 统一入口管理多渠道密钥，省去在业务代码里硬编码多套配置的麻烦。
• 自带令牌、额度与日志功能，适合做团队内部的配额管理。
• Docker 一键部署，跨平台一致，不挑操作系统。

缺点

• 无图形化安装包，对完全没接触过命令行与容器的用户有门槛。
• 系统要求、参数细节需以官方文档为准，本站无收录精确数据。
• 具体功能差异与版本节奏暂无公开对比数据，建议自行在仓库中核对。

同类软件推荐

以下是与本文软件定位相近、可相互替代的同类工具，便于按需选型：

• LiteLLM（同类热门，建议结合官网评估）
• OpenRouter（同类热门，建议结合官网评估）
• Kong（同类热门，建议结合官网评估）

核心功能

• 本页保留官方站点入口作为下载来源，并在可用时提供网盘转存通道，链接与提取码随页面展示。
• 围绕「One API 与 new-api 对比」这一需求给出可执行的获取与部署步骤，减少试错成本。
• 提供版本与架构比对，避免装错版本或选错系统架构导致无法运行。

使用场景

• 需要在本机部署或重装 One API 与 new-api 对比（当前版本），并希望先核对版本与文件信息再获取的场景。
• 使用 One API 与 new-api 对比 时遇到官方站点访问不稳定或速度较慢，需要国内网盘通道作为替代的情况。
• 需要在多台设备使用同一 One API 与 new-api 对比 版本（当前版本），便于统一环境与后续排查时。

注意事项

• 部署 One API 与 new-api 对比 时路径建议避免中文与空格，可减少部分写入失败的概率。
• 若安全软件出现拦截提示，请先确认来源为本页收录渠道后再决定是否放行。

安装与校验

• 通过本页「夸克/百度 网盘」通道转存到自己的网盘后再取回文件，可避免直接下载中断造成的文件不完整。
• 解压后先确认 One API 与 new-api 对比 主程序能否正常启动，再决定是否替换原有版本。
• 如遇安全软件拦截，请先确认来源为本页收录渠道，再决定是否放行。

官方来源获取步骤

• 第 1 步：打开本页给出的官方站点入口，核对页面域名与下方收录信息是否一致。
• 第 2 步：在官方页面的下载区选择与本机 Windows/x64 匹配的安装包，注意区分 32 位与 64 位。
• 第 3 步：下载完成后核对文件名与文件大小，再执行安装或解压；建议解压到 C:\\Tools 这类不含中文与空格的路径。