one-api 是 2023 年 4 月由个人开发者 songquanpeng 开源、用 Go 编写的「LLM API 管理 & 分发系统」:以标准的 OpenAI API 格式统一访问所有大模型,支持令牌管理、额度控制与二次分发,单可执行文件、提供 Docker 镜像、一键部署[1][2]。它不直接向用户收费、不做公司化运营,却成为此后两年国内「API 中转站」生态几乎绕不开的地基——下游分支 new-api 的星标已反超本体[3][4]。
由于众所周知的原因,OpenAI 的 API 在国内访问困难,因此目前出现了一批二手 API 卖家,但是这些二手 API 卖家的稳定性存疑。……或者你也想当 API 卖家,那么本项目也可以帮助你快速搭建一个 API 服务。
—— songquanpeng,《One API》项目介绍页(iamazing.cn,2023-04-23),转引自 [6]| 维度 | 内容 | 信源 |
|---|---|---|
| 产品功能 · 统一适配 | 以标准 OpenAI API 格式访问 28+ 模型供应商(README 官方清单:OpenAI/Azure、Claude/AWS、Gemini、豆包、文心一言、通义千问、星火、ChatGLM、混元、DeepSeek、硅基流动、xAI、Ollama 等),支持负载均衡、失败自动重试、stream 流式、模型映射 | [2] |
| 产品功能 · 密钥管理与二次分发 | 令牌管理(过期时间、额度、IP 白名单、模型范围)、兑换码批量生成与充值、渠道管理、用户/渠道分组倍率、额度明细、美元计价显示、GitHub/微信/飞书 OAuth 登录、管理 API 可无二开扩展 | [2] [4] |
| 生态位 | 「自建 Token 中转站的常用方案」(第三方对比文定性);评价口径「想做白标 API 卖给客户,one-api 比 LiteLLM 更省事」;中转站生意长文印证该生态的规模与玩法(号池、超售、分销),面板级工具是其中游标配 | [4] [9] [10] |
| 衍生项目(下游 fork 生态) | new-api(QuantumNous,2023-11-10 创建):基于 one-api 二次开发,兼容原数据库,新增 Claude/Gemini 原生格式互转、Rerank/Midjourney/Suno 接口、易支付/Stripe 在线充值、数据看板;另有 Gitee 镜像等传播渠道 | [3] [4] [11] |
| 面向客群 | 个人开发者(自用聚合)、中小团队(统一 LLM 网关)、API 卖家/中转站运营者(二次分发与计费底座);中文部署教程在 CSDN、腾讯云开发者社区等平台大量存在,说明下沉使用者广泛 | [6] [9] [10] |
| 解决痛点 | 供给侧:多供应商 SDK/密钥/计费面板割裂、单一渠道故障导致服务中断(负载均衡 + 失败重试);需求侧:国内访问海外模型 API 困难、二手卖家服务质量参差——one-api 提供自建可控的中间层 | [6] [7] [2] |
| 商业模式 | 开源免费、无付费版、无融资披露;变现止于个人网站赞赏入口。商业价值由下游生态间接兑现(new-api 及中转站体系),本体未捕获 | [7] [6] |
| 指标 | 数值 | 时点 / 口径 | 信源 |
|---|---|---|---|
| GitHub 星标 | 37,420 | 2026-11-13 API 实测;案例墙 2026-10/11 时点值 37.3k★、2026-05-30 媒体转引 OSSInsight 29,158★ | [1][7] |
| Forks | 6,894 | 2026-11-13 API 实测(2026-05 媒体口径 5,660) | [1][7] |
| 贡献者 | 100+ | 媒体转引自述口径 | [7] |
| Open issues | 1,045 | 2026-11-13 API 实测——维护停滞的直接表征 | [1] |
| 最新 release / 最后 push | v0.6.10(2025-02-02)/ 2026-01-09 | GitHub API 实测:正式版停更 21 个月、代码停更 10 个月 | [1] |
| 下游 new-api | 51,855★ / 12,645 forks | 2026-11-13 API 实测;与案例墙「51.8k★」口径一致——fork 反超本体 | [3] |
| 生态扩散 | Gitee 镜像收录;CSDN 等平台部署教程持续更新 | 2026-11 检索命中 | [11][12] |
将 one-api 放入案例墙「网关 / API 中转」坐标系(对标数据均取自案例墙既有核验值,本次以 GitHub API 复测一致):
| 对标项目 | 创业者 | 创建时间 | 定位 | 协议 | 数据表现 | 信源 |
|---|---|---|---|---|---|---|
| one-api(本案) | songquanpeng(JustSong) | 2023-04-22 | LLM API 管理 & 分发系统,中转站生态上游 | MIT | 37,420★ / 6,894 forks(实测) | [1] |
| new-api | Calcium-Ion(QuantumNous) | 2023-11-10 | one-api 二次开发的「fork 超越者」,大量商用中转站底座 | AGPLv3 + 附加条款 | 51,855★ / 12,645 forks(实测,案例墙 51.8k★) | [3][4] |
| claude-code-router | musistudio | 2025-02-25 | 让 Claude Code 路由到任意大模型的编程网关,按任务分流供应商 | 开源 | 38,131★ / 3,207 forks(实测,案例墙 38.1k★) | [12] |
| AIClient-2-API(现名 AIClient2API) | justlovemaki | 2025-07-20 | 把 Gemini CLI/Codex 等客户端协议反代为本地 OpenAI 兼容 API | 开源 | 8,978★(实测,案例墙 8.9k★);Docker 下载 10 万+(案例墙口径) | [13] |
四个案例构成一条清晰的谱系:one-api 是最早(2023-04)的公共上游——new-api 直接基于它二次开发并在功能与星标上实现反超(51,855★ vs 37,420★),是开源史上罕见的「fork 超越母项目」样本;claude-code-router 与 AIClient-2-API 则是 2025 年后在新场景(AI 编程客户端路由、客户端协议反代)上的分化物种。三者共同确认了一件事:one-api 定义的「OpenAI 兼容格式 + 令牌计费 + 渠道管理」范式,已经成为中文开发者世界事实上的网关语言——这正是案例墙将 one-api 标注为「事实标准」的依据。
| 维度 | 分析 | 信源 |
|---|---|---|
| 1. 产品功能 | 完整覆盖「聚合—管理—分发」三层:28+ 供应商统一适配、负载均衡与失败重试、令牌/额度/IP/模型范围控制、兑换码充值、分组倍率、模型映射、多机部署、管理 API;单二进制 + Docker + SQLite/MySQL/PG,从个人玩具到小规模生产均可承载 | [2] |
| 2. 生态位(中转站事实标准) | 第三方对比文将其定性为「自建 Token 中转站的常用方案」;下游 new-api 为大量商用中转站底座且兼容 one-api 数据库(迁移路径顺畅);生态长文显示中转站已成产业链(上游号商—中游面板—下游分销),面板级工具即 one-api/new-api 一系的范式。多源旁证成立,但无权威统计直接点名 | [4] [3] [10] |
| 3. 面向客群 | 三层客群:自用型个人开发者(聚合自己的 Key)、中小团队(统一 LLM 网关,评价称「UI 直接给产品经理用」)、中转站运营者(白标 API 卖给客户);部署教程类内容(CSDN 等)的持续产出显示非专业用户占比可观 | [9] [10] [6] |
| 4. 解决痛点 | 核心痛点是「provider fragmentation」:每接一家模型就要管理一套 SDK、认证流与账单。one-api 用一个 OpenAI 兼容端点抹平差异,叠加国内访问海外 API 困难的特殊环境,恰逢 2023 年国产大模型爆发期——「统一适配国产模型」使其成为横跨中西生态的稀缺汇合点 | [7] [2] [6] |
| 5. 商业化与营收(置信度 C) | 零营收披露:无付费版、无融资、无公司主体公开信息,变现仅见个人站赞赏入口。可推断的商业选项(企业版托管、支持服务)均未落地。作为 OPC 样本,其「收入」维度无数据可分析——这是与案例墙内收费型案例(如 ChatWise、Bob)最大的结构差异 | [7] [6] [2] |
| 6. 开源维护可持续性(一人维护的更新节奏) | 实测数据显示明显的节奏滑坡:最新 release v0.6.10 停在 2025-02-02,最后 push 2026-01-09,此后 10 个月无更新,open issues 堆积至 1,045;第三方对比文 2026-07 将其活跃度评为「在维护」(弱于 new-api 的「活跃」);英文媒体早在 2026-05 即警告「无机构支持,长期维护、安全补丁与供应商适配依赖志愿者」。100+ 贡献者存在,但架构决策与发版高度集中于一人 | [1] [4] [7] |
| 7. 合规灰区(API 二次分发) | one-api 的核心场景「key 二次分发」正处于灰色地带:作者在 README 顶部主动置入合规声明——须遵循 OpenAI 使用条款与《生成式人工智能服务管理暂行办法》,「请勿对中国地区公众提供一切未经备案的生成式人工智能服务」;生态长文指出转卖 API 在 Anthropic 服务条款中被禁止(国内无对应条款,风险为封号与支付冻结),并记录了中转站生态的乱象:媒体转述的 CISPA 论文审计称 17 家主流中转站近 45% 存在模型造假,叠加流量虚扣、卷款跑路。工具本身中立,但其最大用例处于上游 ToS 的禁区与国内备案要求的边缘——作者以免责声明「切割」,而非下架功能 | [2] [8] |
本深度报告共引用 13 条信源,按文中首次出现顺序连续编号。上标颜色与文末徽章同色同义:绿 = 已核验(一手可回溯 / ≥2 独立信源交叉),蓝 = 多源印证(单一权威信源可回溯),黄 = 部分映证(自述 / 转述 / 单一 B 级及以下信源)。