开源神器 One API！一键统一整合全网大模型接口！

大家好，我是 Java陈序员。

在日常开发与 AI 工具使用过程中，常常会面临多平台大模型接口杂乱、密钥分散管理麻烦等诸多痛点。想要同时对接多款主流大模型，不仅需要反复适配不同接口协议，还要单独维护各类密钥与调用额度，流程繁琐且效率极低。

今天，给大家分享一款开源神器 —— One API，轻松实现全品类大模型接口统一管理！

关注微信公众号：【Java陈序员】，获取开源项目分享、AI副业分享、超200本经典计算机电子书籍等。

项目介绍

one-api —— 开源的大模型 API 统一网关，用一套 OpenAI 标准接口，对接所有主流大模型，一站式管理、分发、调度。

功能特色：

• 全模型统一兼容：遵循 OpenAI 标准接口格式，一键接入国内外几十款主流大模型，客户端无需改代码，可随意切换调用
• 多渠道智能调度：支持多渠道轮询、权重分流、故障自动切换、失败重试，有效提升接口稳定性，避免单点故障
• 精细化额度管控：支持用户分组、渠道倍率计费、令牌额度限制、IP 白名单、模型调用权限隔离，精准控流控费
• 便捷充值分销体系：内置兑换码批量生成、用户充值、邀请返利、消费明细统计，轻松搭建分销与付费调用体系
• 轻量化极简部署：支持 Docker 一键极速部署，默认内置 SQLite 免装数据库，也可无缝切换 MySQL
• 高度自定义美化：可自定义网站 LOGO、首页文案、页脚信息、主题样式，支持中英文多语言切换
• 安全权限管理：独立管理员后台、普通用户区分权限，密钥分级管理
• 轻量高效易运维：占用资源低、启动速度快，后台可视化数据看板，实时查看调用量、消耗、在线状态

技术栈：

• 后端：Go + Gin + SQLite/MySQL/PostgreSQL + Redis
• 前端：React

快速上手

one-api 支持 Docker 部署，可使用 Docker 一键部署。

Docker 命令部署

1、拉取镜像

docker pull justsong/one-api

如果镜像无法拉取，可以尝试使用 GitHub 的 Docker 镜像：

docker pull ghcr.io/songquanpeng/one-api

2、创建数据挂载目录

mkidr -p /data/software/one-api

3、运行容器

• 使用 SQLite 数据库

docker run -d --name one-api \
	-p 3000:3000 \
	-e TZ=Asia/Shanghai \
	-v /data/software/one-api:/data \
	justsong/one-api

• 使用 MySQL 数据库

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

4、容器运行成功后，浏览器访问

http://{IP/域名}:3000

Docker Compose 部署

1、下载 docker-compose.yaml 文件

## 创建项目文件夹
mkdir -p /data/software/one-api

## 进入项目目录
cd /data/software/one-api

## 下载 docker-compose.yaml
wget -o docker-compose.yml https://raw.githubusercontent.com/songquanpeng/one-api/refs/heads/main/docker-compose.yml

2、运行启动

docker compose up -d

3、运行成功后，浏览器访问

http://{IP/域名}:3000

超级管理员账号

1、超级管理员账号用户名为 root, 密码为 123456.

2、使用 root 用户初次登录系统后，务必修改默认密码！

功能体验

• 渠道管理

• 令牌管理

• 兑换管理

• 充值中心

• 用户管理

• 数据总览

• 操作日志

• 运营设置

本地开发

项目依赖 Go、Node.js 环境，需提前进行安装。

1、克隆或下载项目源码

git clone https://github.com/songquanpeng/one-api.git

2、构建前端

## 进入前端项目目录
cd one-api/web/default

## 安装依赖
npm install

## 构建打包
npm run build

3、构建后端

go mod download
go build -ldflags "-s -w" -o one-api

4、启动运行

chmod u+x one-api
./one-api --port 3000 --log-dir ./logs

5、运行成功后，浏览器访问

http://localhost:3000/ 

初始账号用户名为 root, 密码为 123456.

可以说，one-api 是一款功能齐全的大模型 API 统一网关，不仅支持多渠道负载均衡、自动故障切换、请求失败重试，同时内置完善的用户权限管理、密钥分发、额度管控、计费倍率、兑换码生成、消费数据统计等商业化实用功能，既适合个人自用聚合管理密钥，也可轻松搭建 API 分发、付费调用服务体系。快去部署体验吧~

项目地址：https://github.com/songquanpeng/one-api

最后

推荐的开源项目已经收录到 GitHub 项目，欢迎 Star：

https://github.com/chenyl8848/great-open-source-project

或者访问网站，进行在线浏览：

https://chencoding.top:8090/#/

我创建了一个开源项目交流群，方便大家在群里交流、讨论开源项目。

但是任何人在群里打任何广告，都会被 T 掉。

如果你对这个交流群感兴趣或者在使用开源项目中遇到问题，可以通过如下方式进群：

关注微信公众号：【Java陈序员】，回复【开源项目交流群】进群，或者通过公众号下方的菜单添加个人微信，并备注【开源项目交流群】，通过后拉你进群。

大家的点赞、收藏和评论都是对作者的支持，如文章对你有帮助还请点赞转发支持下，谢谢！

---