☰
One-API 快速上手:三条命令部署,多模型统一 API 网关从注册到额度分发全流程
2026/10/15 0:03:53 网站建设 项目流程

One-API 快速上手:三条命令部署,多模型统一 API 网关从注册到额度分发全流程

【免费下载链接】one-apiLLM API 管理 & 分发系统,支持 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、ChatGLM、文心一言、讯飞星火、通义千问、360 智脑、腾讯混元等主流模型,统一 API 适配,可用于 key 管理与二次分发。单可执行文件,提供 Docker 镜像,一键部署,开箱即用。LLM API management & key redistribution system, unifying multiple providers under a single API. Single binary, Docker-ready, with an English UI.项目地址: https://gitcode.com/GitHub_Trending/on/one-api

团队里大家都在共用一个 OpenAI Key,额度快烧完了,却没人说得清谁调了多少次、花了多少?这时候就需要一个 AI 接口管理和多模型统一接入的系统——One-API 把 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、豆包、ChatGLM、文心一言这些上游 Key 收进来,对外只暴露一个标准 API 网关,按用户发额度、按调用记消耗。下面按时间线走一遍:先拉起服务,再放用户进来,然后给团队发额度,最后学会看用量数据。

第一次进控制台:用 Docker 三条命令把服务跑起来 🐳

先 clone 仓库,再进目录,最后拉起容器:

git clone https://gitcode.com/GitHub_Trending/on/one-api cd one-api docker-compose up -d

就这三条。docker-compose.yml 里已经带好了 Redis 和 MySQL,不想装 MySQL 的话把 SQL_DSN 那行注释掉,它会退回到 SQLite。服务起来后监听 3000 端口,浏览器访问就能进管理后台。整个系统是一个单可执行文件,没有前后端分离的麻烦,这是它上手快的根本原因。

第一次让用户进来:四种注册渠道和 JWT 登录

进后台第一件事,是把注册开关和渠道配置好。One-API 给了四条路,按需开放:

  • 邮箱注册,走最常规的注册表单,见 Register.js
  • GitHub OAuth,适合开发者用户,实现在 controller/auth/github.go
  • 微信登录,面向国内个人用户,见 controller/auth/wechat.go
  • Lark 登录,企业场景用得上,见 controller/auth/lark.go

登录后会话由 JWT 令牌维持,校验逻辑在 middleware/auth.go;敏感操作(比如改密码、高危接口)还会叠加图形验证码,代码在 common/verification.go。注意一点:渠道开多了记得在后台逐一测试回调,尤其是微信和 Lark 的回调地址配置,漏配一步登录就会卡在授权页。

第一次给团队发额度:生成并分发 redemption 兑换码

用户进来后是空账户,额度靠管理员发放。这里用 redemption 码,而不是直接改余额:

  1. 管理员在后台按金额生成一批码,逻辑在 controller/redemption.go
  2. 用户拿码到充值页兑换,额度直接加到账户上
  3. 码用完即作废,发放记录在 model/redemption.go 里可查

这样做的好处是发放过程留痕、可批量、可回收,发错了也能对着记录找到是哪一批。

平台替你算钱:配置分模型计费后自动扣减

接下来不用你盯,系统自动处理。每接入一个渠道,relay/adaptor/ 下对应的适配器会把各家不统一的返回格式转成标准结构;请求完成后,relay/billing/ 按模型名和分组找到对应的倍率,用本次消耗的 token 数算出实际花费,再从账户余额里扣掉。不同模型单价不同,分组倍率也不同,所以"同一个 Key 走不同渠道"时,账单是分开算的,不用手动对账。

第一次看懂用量:日志和监控面板

用了一段时间后,问题会变成"钱花在哪了"。看两个地方就够:

  • 逐条调用日志:谁、哪个模型、多少 token、扣了多少额度,记录在 model/log.go
  • 统计与渠道监控:QPS、成功率、渠道响应时长,指标定义在 monitor/metric.go

先查日志定位异常用户,再看监控判断渠道健不健康,两边对不上再去查具体渠道配置。

让用户带来用户:邀请奖励机制

想让账户增长不依赖你自己拉人,可以打开邀请奖励:新用户带邀请码注册后,邀请人和被邀请人都会自动获赠额度,相关流水见 model/user.go,前端入口在 InviteCard.js。规则很简单,奖励额度和新用户基础额度都在系统设置里可调,注意别让奖励比基础额度高,否则会被刷。

拉起来、放人进来、发额度、看账单——四步走完,一个能对外服务的统一 API 入口就算建好了。剩下的事,就是按团队规模调倍率和渠道配置。

【免费下载链接】one-apiLLM API 管理 & 分发系统,支持 OpenAI、Azure、Anthropic Claude、Google Gemini、DeepSeek、字节豆包、ChatGLM、文心一言、讯飞星火、通义千问、360 智脑、腾讯混元等主流模型,统一 API 适配,可用于 key 管理与二次分发。单可执行文件,提供 Docker 镜像,一键部署,开箱即用。LLM API management & key redistribution system, unifying multiple providers under a single API. Single binary, Docker-ready, with an English UI.项目地址: https://gitcode.com/GitHub_Trending/on/one-api

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询