AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
把多家大模型 API 统一成 OpenAI 格式,并做密钥管理与分发。
One API 是一个 LLM API 管理与分发系统,通过标准 OpenAI API 格式访问 OpenAI、Azure、Claude、Gemini、DeepSeek、豆包、文心一言、通义千问等主流模型。它提供密钥管理、渠道负载均衡、令牌与兑换码管理,可用于二次分发。项目为单可执行文件,提供 Docker 镜像,开箱即用。
推荐指数
多模型统一接入与分发场景下成熟度高、部署简单,值得优先考虑。
近 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 步
配置渠道
在管理后台添加上游供应商的 API 密钥和模型列表。
第 2 步
创建令牌
为使用者生成令牌,设置额度、过期时间和允许的模型。
第 3 步
统一请求
客户端按 OpenAI API 格式请求 One API,由它转发到对应渠道。
第 4 步
计费与重试
系统记录额度消耗,请求失败时按配置自动重试其他渠道。
快速上手
- 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
登录后台
访问 http://localhost:3000,用 root 初次登录后立即修改默认密码 123456。
- 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 许可,可自由使用和修改。
