one-api

One API：统一所有大模型 API 的「超级网关」

一个痛点引发的开源项目

如果你同时在用 OpenAI 的 GPT-4、百度的文心一言、阿里云的通义千问，以及最近火热的 DeepSeek，你会发现每个平台的 API 格式都不一样：接口地址不同、鉴权方式不同、模型名称不同。每次换模型都要改代码，调试成本极高。One API 正是为解决这个痛点而生——它把所有大模型的 API 统一成 OpenAI 的标准格式，让你在任何支持 OpenAI API 的工具中，只需换一个地址和 Key，就能自由切换任意大模型。

这个项目的作者是 GitHub 用户 songquanpeng（JustSong），项目于 2022 年启动，至今已收获超过 34,000 颗星、6,500 个 Fork、1,000 多个 open issues，活跃度在同类项目中稳居第一梯队。更重要的是，它不只是一个技术工具——它正在成为大量第三方 API 售卖平台背后的技术底座。

背景：多模型时代的 API 管理困境

2022-2023 年是大模型爆发元年，OpenAI GPT 系列、Anthropic Claude、Google PaLM/Gemini、百度文心一言、阿里通义千问、字节豆包等数十个大模型平台陆续开放 API。每个平台都有自己独特的接入方式：不同的 endpoint、不同的鉴权头、不同的模型标识符。对于开发者而言，这意味着要么针对每个平台写独立适配层，要么忍受混乱的 API 调用逻辑。

更棘手的是成本管理和流量控制问题。团队往往需要同时使用多个模型服务商的 API key，如何统一管理这些 key、如何做负载均衡、如何防止 key 泄露后的额度滥用，都是现实挑战。One API 的核心价值，就是把这个混乱的局面用一个统一的入口来管理起来。

它到底是什么：一句话解释

One API 是一个开源的大模型 API 网关（API Gateway）和密钥管理系统。 它本质上是一个反向代理服务器，接收来自客户端的 OpenAI 格式请求，然后根据配置将请求转发给真实的大模型服务商。它的角色类似于机场的「统一登机口」——乘客（应用）只需要知道一个入口，而登机口（One API）会根据目的地（模型）自动分配到正确的登机口（真实 API）。

核心功能：从接入到分发的完整闭环

1. 多模型统一接入（最核心功能）

One API 支持接入 30+ 主流大模型服务商，包括国际主流模型（OpenAI GPT 系列含 Azure、Anthropic Claude 系列含 AWS Claude、Google PaLM2/Gemini、Mistral、Groq、DeepSeek、Cohere、xAI 等）、国内主流模型（百度文心一言、阿里通义千问、腾讯混元、字节豆包、智谱 ChatGLM、讯飞星火、360 智脑、Moonshot AI Kimi、百川大模型、零一万物、阶跃星辰等）、本地模型（Ollama）以及第三方聚合服务（硅基流动 SiliconCloud、Novita AI、Together AI、DeepL 等）。接入方式只需在后台配置「渠道」，填入对应平台的 API Key 和 endpoint 地址，即可立即通过统一的 OpenAI 格式调用，无需修改任何客户端代码。

2. 密钥管理与令牌系统

One API 提供了完善的密钥管理体系：可以为不同用户或不同用途生成独立的 API 令牌（Token），设置每个令牌的额度上限、过期时间、IP 白名单和可用模型范围。这意味着团队可以给不同成员分配不同的额度以避免单点耗尽，可以限制某些令牌只能访问特定模型（如只允许测试账号访问 GPT-4），还可以设置 IP 白名单防止令牌被盗用。

3. 负载均衡与故障转移

当配置了多个同一模型的渠道时，One API 支持负载均衡策略——自动在多个 API Key 之间分配请求。如果某个 Key 额度耗尽或响应超时，系统会自动切换到备用 Key，用户完全无感知。这对于高可用生产环境极为重要。

4. 额度与兑换码系统

支持批量生成和导出兑换码，用户可以通过兑换码为账户充值额度。系统还支持查看详细的额度消费明细，以及设置新用户注册赠送额度。对于商业化运营场景（如 API 二次分发），这是核心功能。

5. 三大 Web UI 主题

One API 自带管理后台，提供三个 Web UI 主题（default、berry、air），通过设置环境变量 THEME 即可切换。管理界面包含渠道管理、用户管理、令牌管理、额度管理、日志查看等完整功能。

6. 认证与登录

支持多种登录方式：邮箱注册/登录、GitHub OAuth、飞书授权登录，以及微信公众号授权。对于企业内部部署，可以对接已有的飞书或 GitHub SSO 体系。

7. 自定义与扩展

支持自定义系统名称、Logo、页脚，支持自定义首页和关于页面（支持 HTML 和 Markdown），支持 Cloudflare Turnstile 人机验证，以及系统访问令牌（System Access Token）用于无二开扩展功能。

技术架构：Go + Gin + React 的稳健组合

从代码结构来看，One API 的架构非常清晰：web/ 目录包含 React 前端（内置3个主题），router/ 目录负责 Gin 路由注册，controller/ 是 HTTP 控制器层，model/ 是数据模型层（GORM），relay/ 是请求转发层（核心，负责模型适配），middleware/ 提供认证、日志等中间件，common/ 是通用工具，monitor/ 是监控指标。

后端采用 Go 语言 + Gin Web 框架（Go 1.20+），数据库层支持 SQLite（默认，适合个人/轻量级部署）、MySQL（推荐生产环境）和 PostgreSQL，同时支持 Redis 用于缓存和会话管理。前端使用 React 构建，打包成静态文件后通过 Gin 的静态文件中间件直接服务，前后端打包在一个 Docker 镜像中，部署极为简单。relay/ 目录是整个项目的核心——负责接收 OpenAI 格式的请求，将其转换为目标平台的请求格式，再将响应转换回 OpenAI 格式返回给客户端，这是一个标准的「适配器模式」实现。

部署体验：Docker 一键搞定

这是 One API 最令人称道的地方——部署复杂度几乎为零。官方提供了两种极简部署方式：

方式一：Docker 单命令部署（SQLite）

docker run --name one-api -d --restart always   -p 3000:3000 -e TZ=Asia/Shanghai   -v /home/ubuntu/data/one-api:/data   justsong/one-api

一条命令，数据自动持久化到宿主机目录，初始账号 root / 123456，登录后立刻配置模型渠道。

方式二：Docker Compose 部署（MySQL）

docker-compose up -d

自动启动 One API + MySQL + Redis，一条命令搞定完整生产级部署。

Dockerfile 采用多阶段构建（multi-stage）：第一阶段用 Node.js 构建 React 前端，第二阶段用 golang:alpine 编译 Go 二进制，第三阶段用 alpine:latest 作为最终运行环境，最终镜像非常精简。项目还支持通过宝塔面板一键部署，对不熟悉命令行的用户非常友好。

使用场景：谁在用 One API？

根据项目文档和社区反馈，One API 的典型使用场景包括：个人开发者在一个项目中集成多个模型无需管理多个 API Key、AI 应用开发者为 AI 应用提供统一的模型接入层方便后续切换模型、API 二次分发商（许多国内 API 售卖平台如硅基流动等的底层技术就是 One API）、企业内部 AI 平台统一管理多个部门的模型调用和计费审计，以及 AI 应用聚合平台将不同模型的能力整合到一个应用中。

局限与挑战

诚实地看，One API 也面临一些挑战：国内大模型更新频繁，每次接入新模型都需要更新 relay 层代码，存在一定的更新滞后；并非所有 OpenAI API 特性都被支持，复杂的 function calling、vision 等功能需要逐一适配；作为 API 网关，如果部署在公网，需要特别注意令牌管理和 IP 限制，防止被恶意刷用额度；超过 1000 个 open issues 说明项目维护压力较大，部分 issue 响应可能较慢。

行业意义：从工具到基础设施

One API 不仅仅是一个开源项目，它正在成为 AI 应用生态中的「水管工」角色。在当前大模型市场分散、竞争激烈的背景下，一个可靠的 API 网关对降低 AI 应用开发门槛至关重要。它的存在让开发者可以：不要把所有鸡蛋放在一个篮子里——可以同时使用多个模型服务商，One API 帮你管理这个复杂度。从增长曲线看，34K stars 和 6.5K forks 的数据表明，它的影响力已经远超同类闭源商业产品。在 2026 年企业级大模型选型的背景下，One API 的定位——轻量、免费、自托管——恰好契合了大量不愿将 API 数据交给第三方的企业的核心诉求。

---

分析时间：2026-05-25 | 数据来源：GitHub API + 官方 README