AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日
基于 one-api 二次开发的 OpenAI 接口管理与分发系统,支持更多模型和统计功能。
One Hub 是一个 OpenAI 接口管理与分发系统,改自 songquanpeng/one-api。它支持更多模型供应商,新增了用户仪表盘和管理员统计页面,并完善了非 OpenAI 模型的函数调用。
推荐指数
功能丰富、更新活跃的 one-api 增强版,适合需要多模型管理和统计的开发者。
总 Star 排名
#1820
雷达追踪的 3,958 个 AI 仓库中
创建于
2023
2023年9月9日
核心亮点
1多供应商支持
支持 OpenAI、Azure、Anthropic、Gemini、百度文心、通义千问等数十种模型供应商。
2统计与仪表盘
新增用户仪表盘和管理员分析数据统计界面,便于监控使用情况。
3函数调用优化
支持和优化非 OpenAI 模型的函数调用,可在 lobe-chat 等客户端直接使用。
4支付与计费
支持支付功能、模型按次收费、完成倍率自定义等计费方式。
5监控与集成
支持 Prometheus 监控、Uptime Kuma 状态监控和 Telegram bot。
适用场景
多模型 API 统一管理
例如:企业内同时使用 OpenAI、Claude 和通义千问,通过 One Hub 统一分发和计费。
API 用量统计与分析
例如:管理员通过统计页面查看各渠道的请求量、耗时和费用分布。
非 OpenAI 模型的函数调用
例如:在 lobe-chat 中调用 Claude 模型并使用函数调用功能。
API 代理与负载均衡
例如:为不同渠道配置独立的 http/socks5 代理,实现网络隔离和负载均衡。
它是怎么工作的
第 1 步
配置渠道
在后台添加各模型供应商的 API 密钥和代理设置。
第 2 步
创建令牌
生成用户令牌,设置额度、分组和模型访问权限。
第 3 步
分发请求
客户端使用统一接口地址和令牌调用,系统根据模型路由到对应渠道。
第 4 步
统计与计费
系统记录请求日志、耗时和费用,并生成统计报表和月度账单。
快速上手
- 1
Docker 部署
使用 Docker 快速启动 One Hub 服务。
docker run -d --name one-hub -p 3000:3000 -v /path/to/data:/data martialbe/one-api - 2
访问后台
浏览器打开 http://localhost:3000,使用默认管理员账号登录。
- 3
添加渠道
在后台“渠道”页面添加模型供应商的 API 密钥。
- 4
创建令牌
在“令牌”页面生成访问令牌,即可通过 API 调用。
适合谁
- 需要统一管理多个 AI 模型 API 的开发者
- 希望统计 API 用量和费用的团队
- 需要为非 OpenAI 模型提供函数调用支持的场景
不太适合
- 追求稳定性和官方技术支持的企业用户
- 只需要单一 OpenAI 接口的简单场景
成熟度
- 活跃度最近一次推送在 2026 年 2 月,更新频繁。
- 文档有独立文档站点,但 README 中部分链接指向原项目。
- 社区近 2900 星、496 分支,140 个开放 issue,社区有一定活跃度。
- 上手难度提供 Docker 镜像和配置文件启动,部署较简单。
同类项目怎么选
- one-api原版项目,功能较少但更稳定,数据库与 One Hub 不兼容。
- new-api另一个 one-api 分支,侧重不同功能扩展。
使用前注意
- · 数据库与原版 one-api 不兼容,不能混用。
- · 项目为个人学习使用,不保证稳定性,不提供技术支持。
- · 需遵守 OpenAI 使用条款和当地法律法规,不得用于非法用途。
- · 对中国地区公众提供生成式 AI 服务需完成备案。
