songquanpeng GitHub avatar

one-api

JavaScript
大模型接口管理网关songquanpeng最近推送 2026年1月9日
模型推理与部署MIT37.4k6,8851,045 issues7 天 +36

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

把多家大模型 API 统一成 OpenAI 格式,并做密钥管理与分发。

One API 是一个 LLM API 管理与分发系统,通过标准 OpenAI API 格式访问 OpenAI、Azure、Claude、Gemini、DeepSeek、豆包、文心一言、通义千问等主流模型。它提供密钥管理、渠道负载均衡、令牌与兑换码管理,可用于二次分发。项目为单可执行文件,提供 Docker 镜像,开箱即用。

推荐指数

5.0

多模型统一接入与分发场景下成熟度高、部署简单,值得优先考虑。

近 7 天

+36

新增 Star

总 Star 排名

#171

雷达追踪的 3,958 个 AI 仓库中

创建于

2023

2023年4月22日

核心亮点

  • 1统一 API 格式

    用 OpenAI 兼容格式调用数十家模型供应商。

  • 2渠道负载均衡

    可配置多个渠道并自动重试失败请求。

  • 3令牌与额度管理

    支持令牌过期、额度、IP 范围和模型访问限制。

  • 4兑换码与用户分组

    可批量生成兑换码充值,并按分组设置倍率。

  • 5部署简单

    单可执行文件或 Docker 一键启动,支持 SQLite/MySQL。

适用场景

  • 团队统一接入多模型

    例如:后端只对接 One API 的 OpenAI 格式地址,按需切换 Claude 或通义千问。

  • API 密钥二次分发

    例如:给不同成员发放令牌并设置额度和可用模型,集中管理上游密钥。

  • 多渠道路由与容灾

    例如:同一模型配置多个上游渠道,失败时自动重试其他渠道。

  • 小规模运营充值

    例如:生成兑换码给用户充值,查看额度明细和邀请奖励。

它是怎么工作的

  1. 第 1 步

    配置渠道

    在管理后台添加上游供应商的 API 密钥和模型列表。

  2. 第 2 步

    创建令牌

    为使用者生成令牌,设置额度、过期时间和允许的模型。

  3. 第 3 步

    统一请求

    客户端按 OpenAI API 格式请求 One API,由它转发到对应渠道。

  4. 第 4 步

    计费与重试

    系统记录额度消耗,请求失败时按配置自动重试其他渠道。

快速上手

  1. 1

    Docker 启动

    使用 SQLite 默认配置启动容器,映射 3000 端口并挂载数据目录。

    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
  2. 2

    登录后台

    访问 http://localhost:3000,用 root 初次登录后立即修改默认密码 123456。

  3. 3

    添加渠道

    在渠道管理中添加供应商密钥和模型,创建令牌后即可调用。

适合谁

  • 需要统一接入多家大模型的开发团队
  • 想集中管理 API 密钥并做二次分发的服务运营者
  • 希望用 OpenAI 格式兼容多供应商的开发者

不太适合

  • 只需要单一模型、不想维护中间层的个人项目
  • 对合规备案有严格要求且无法自行处理的场景

成熟度

  • 活跃度最近一次推送在 2026 年 1 月,持续维护。
  • 文档README 覆盖功能、部署和环境变量,较完整。
  • 社区约 3.7 万 star、6800 多 fork,社区规模大。
  • 上手难度Docker 一条命令可启动,后台配置直观。

同类项目怎么选

  • LiteLLM同样做多模型统一代理,偏 Python 生态和 SDK 集成。
  • New API基于 One API 的衍生项目,界面和功能有额外扩展。

使用前注意

  • · 默认 root 密码为 123456,初次登录必须修改。
  • · 并发量较大时需配置 SQL_DSN 使用 MySQL,避免 SQLite 瓶颈。
  • · 使用需遵守 OpenAI 条款和当地法律法规,不得用于非法用途。
  • · 项目采用 MIT 许可,可自由使用和修改。

主题标签

openai-apiproxychatgptgptopenaiapiapi-gatewayazure-openai-apiclaudeernie-botgemini