MartialBE GitHub avatar

one-hub

Go
OpenAI 接口分发系统MartialBE最近推送 2026年2月20日
模型推理与部署Apache-2.02,898497140 issues

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

基于 one-api 二次开发的 OpenAI 接口管理与分发系统,支持更多模型和统计功能。

One Hub 是一个 OpenAI 接口管理与分发系统,改自 songquanpeng/one-api。它支持更多模型供应商,新增了用户仪表盘和管理员统计页面,并完善了非 OpenAI 模型的函数调用。

推荐指数

4.0

功能丰富、更新活跃的 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. 第 1 步

    配置渠道

    在后台添加各模型供应商的 API 密钥和代理设置。

  2. 第 2 步

    创建令牌

    生成用户令牌,设置额度、分组和模型访问权限。

  3. 第 3 步

    分发请求

    客户端使用统一接口地址和令牌调用,系统根据模型路由到对应渠道。

  4. 第 4 步

    统计与计费

    系统记录请求日志、耗时和费用,并生成统计报表和月度账单。

快速上手

  1. 1

    Docker 部署

    使用 Docker 快速启动 One Hub 服务。

    docker run -d --name one-hub -p 3000:3000 -v /path/to/data:/data martialbe/one-api
  2. 2

    访问后台

    浏览器打开 http://localhost:3000,使用默认管理员账号登录。

  3. 3

    添加渠道

    在后台“渠道”页面添加模型供应商的 API 密钥。

  4. 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 服务需完成备案。

主题标签

chatgptopenaiopenai-api