one-api

一个网关管所有大模型API，统一密钥、分发、监控

开源 🏷️定价信息待确认 ✅ 目前可打开对话助手 🍴 复刻 6887 🐛 待处理 1045 👀 关注 187

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 37393

维护状态低维护

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类对话助手

开发团队songquanpeng

官网地址https://oneapi.justsong.cn

GitHubhttps://github.com/songquanpeng/one-api

定价模式🏷️定价信息待确认

价格说明开源项目，可自行部署，官网未明确提供在线服务或定价信息。

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型api,api-gateway,azure-openai-api,chatgpt,claude,ernie-bot,gemini,gpt,openai,openai-api,proxy

GitHub 星标★ 37393

上线时间2023-04-22 00:00:00

代码更新2026-01-09

仓库体积15.6 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数5

项目介绍

one-api 是一个开源的 LLM API 管理与分发系统，旨在解决多个大模型 API 密钥分散、调用方式不统一、难以集中管控和二次分发的问题。它支持 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、ChatGLM、文心一言、讯飞星火、通义千问等主流模型，通过统一的 API 格式适配所有上游提供商，用户只需一个 API 地址和密钥即可调用所有模型。核心能力包括：密钥管理与额度控制、多渠道负载均衡、请求日志与统计、用户/令牌管理、以及通过 API 进行二次分发，适合团队或平台方将模型能力转售或共享。项目提供单可执行文件和 Docker 镜像，一键部署，开箱即用，并带有英文界面，降低了使用门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 37393

技术标签

api api-gateway chatgpt claude gemini

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

已安装 Docker 环境（可用 docker 命令）
一台可访问外网的服务器或本机，端口 3000 未被占用
准备一个用于持久化数据的宿主机目录，如 /home/ubuntu/data/one-api
可选：如使用 MySQL 需自备数据库连接参数（用户名、密码、地址、端口、库名）

安装与启动步骤

1启动 One API 容器

用 SQLite 存储数据，挂载宿主机目录到容器 /data 保证数据不丢；端口映射到宿主机 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改用 MySQL 存储（可选）

在上面命令基础上增加 SQL_DSN 环境变量即可换成 MySQL，请按实际数据库修改连接参数。

docker run --name one-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" -v /home/ubuntu/data/one-api:/data justsong/one-api

3登录管理后台

浏览器打开 http://localhost:3000/ ，用初始账号 root、密码 123456 登录，登录后立即修改密码。
4在渠道页添加 API Key

进入“渠道”页面，填入你要使用的大模型上游 API Key，完成渠道配置。
5在令牌页新增令牌

进入“令牌”页面新增一个访问令牌，这个令牌就是后续调用 One API 时使用的 API Key。
6客户端接入 One API

在任意使用 OpenAI API 的客户端里，把 API Base 设为你的部署地址 /v1，API Key 填上一步生成的令牌。
```
OPENAI_API_KEY="sk-xxxxxx"
OPENAI_API_BASE="https://<HOST>:<PORT>/v1"
```

关键配置

配置项	必填	说明	示例
`TZ`	是	容器时区，影响日志与统计时间显示	`Asia/Shanghai`
`SQL_DSN`	否	数据库连接串，填写后使用 MySQL 而非 SQLite	`root:123456@tcp(localhost:3306)/oneapi`
`SESSION_SECRET`	否	会话密钥，多机部署时所有服务器需设为相同值	`your-session-secret`
`NODE_TYPE`	否	节点类型，从服务器需设为 slave，默认主服务器	`slave`
`SYNC_FREQUENCY`	否	定期从数据库同步配置的频率，使用远程数据库时推荐设置	`60`
`REDIS_CONN_STRING`	否	Redis 连接串，启用后可减少数据库访问降低延迟	`redis://default:123456@localhost:6379`

如何确认成功

浏览器访问 http://localhost:3000/ 能打开登录页，用 root / 123456 成功登录即部署成功。

常见问题

Q：初始账号和密码是什么？

A：用户名为 root，密码为 123456，登录后请立刻修改，避免被他人使用。

Q：数据存在哪里，容器删了会丢吗？

A：SQLite 模式数据存在挂载的 /data 目录（如 /home/ubuntu/data/one-api），删除容器后数据仍在；用 MySQL 则存数据库。

Q：客户端里的 API Base 应该怎么填？

A：填你的 One API 部署地址加 /v1，例如 https://<HOST>:<PORT>/v1，具体格式取决于所用客户端。

Q：如何指定用某个渠道处理请求？

A：在令牌后拼接渠道 ID，例如 Authorization: Bearer ONE_API_KEY-CHANNEL_ID，且必须使用管理员创建的令牌。

Q：不指定渠道时会怎样？

A：不指定渠道 ID 时会按负载均衡的方式在多个渠道之间分发请求。

注意事项

本项目为开源项目，使用时必须遵循 OpenAI 使用条款及当地法律法规。
多机部署时所有服务器的 SESSION_SECRET 必须一致，且必须设置 SQL_DSN 使用同一个 MySQL，从服务器设置 NODE_TYPE=slave。
系统开箱即用，可通过环境变量或命令行参数配置；不清楚某项含义时，可临时删掉该值以看到提示文字。