如何把十几家大模型 API 收成一个入口：One-API 完整上手指南

如何把十几家大模型 API 收成一个入口One-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、Claude、DeepSeek、文心一言、通义千问好几家的 key大概率被这几件事烦过每家接口格式不一样工具要逐个改想把 key 共享给团队又怕用量失控月底想算清每个人烧了多少钱根本无从下手。One-API 是一个 LLM API 管理与分发系统把这些厂商的接口收敛成一个统一的 OpenAI 格式入口——下游工具只填一个 base URL以后换模型、换渠道只改 model 字段。可以把它理解成快递驿站各厂商是寄件网点驿站统一收口收件人只跑一个窗口这是大模型 API 统一管理的典型做法。10 分钟把 One-API 跑起来仓库自带 compose 文件一条命令启动git clone https://gitcode.com/GitHub_Trending/on/one-api cd one-api docker-compose up -d仓库根目录的 docker-compose.yml 已经写好服务编排docker-compose up -d之后访问本机 3000 端口就能进管理后台。compose 文件默认注释掉 MySQL 配置也就是先用内置 SQLite 跑着——单人或小团队阶段够用要接长期服务或多机再解开SQL_DSN那行换成 MySQL。启动后先做三件事改 root 默认密码123456、把SESSION_SECRET换成随机字符串、确认端口没被占用。这三件都花不了两分钟却省掉后面 90% 的线上事故。给团队发第一批令牌渠道贴 key 的地方后台渠道页填上你的厂商 key选对应类型。支持同一模型挂多个渠道流量按权重分流某个渠道挂了会自动切到下一个重试。想让用户看到统一的模型名可以配模型映射但它会重构造请求体未适配的字段会传丢没必要就别设。令牌发给同事的钥匙令牌页生成的 key 就是给团队用的可以单独设额度上限、过期时间、允许的模型和 IP 范围。注意账户额度和令牌额度是两本账账户额度是总池子令牌额度是给这把 key 划的天花板。同事那边的工具只需把 OpenAI base URL 换成你的 One-API 地址API key 填令牌之后切模型只改 model 参数。登录和鉴权这一层在 middleware/auth.go 里浏览器走 session脚本走 access token被拉黑的用户直接拒掉。发额度与管用户批量生成兑换码省掉逐人操作不想开网页一个个充值兑换码支持批量生成和导出每张码绑定固定额度用户在充值页输入即入账。码的生命周期——启用、禁用、已用——逻辑在 model/redemption.go 里写得很直白。分组倍率让账单对得上用户和渠道都支持分组不同组配不同倍率。比如访客用基础组、核心用户用高消耗组额度消耗按倍率折算月底对账时数字能对上。新用户初始额度、邀请奖励、首页公告都可在设置页调。这几个坑先绕开再省时间令牌额度 ≠ 账户额度令牌额度用尽会报额度不足但账户可能还有余额别混为一谈。模型映射别乱开它会把请求体重新构造未适配的字段传不过去。想指定渠道用Authorization: Bearer 令牌-渠道ID的写法且只有管理员创建的令牌才能这么用。想无二开扩展系统管理 API 加访问令牌即可调用接口清单见 docs/API.md。想深入了解各厂商的适配细节可以翻翻 relay/adaptor/ 目录一家一个子包其余使用细节看 README.md 就够。One-API 把十几家大模型 key 收进一个入口、一套额度账本下游工具和团队都只对接一个 base URL。先把 docker-compose 跑起来给自己发第一把令牌剩下的跟着上面三节走就行。【免费下载链接】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），仅供参考