5步搭出自己的AI接口平台One Hub二次开发实战【免费下载链接】one-apiOpenAI 接口管理 分发系统改自songquanpeng/one-api。支持更多模型加入统计页面完善非openai模型的函数调用。项目地址: https://gitcode.com/gh_mirrors/one/one-apiOne Hub 是一款开源的 AI 接口平台即 AI 接口管理与分发系统基于 one-api 项目二次开发而来支持多模型接入、用量统计页面和非 OpenAI 模型的函数调用。这篇 One Hub 二次开发教程按同事带你上手的节奏走改什么、去哪改、改完怎么验证。你可能想改什么动手前先对号入座三个常见诉求。一是想接入目前用不上的模型接口比如自建的推理服务、默认列表里没有的新厂商。二是想定制管理界面换 logo、加计费列、让日志页显示自己的字段。三是想换部署方式不想裸跑想切到 Docker 或放进内网环境。命中任意一条都值得往下看。5分钟跑起来本地环境环境要求一句话Go 1.20、Node.js 16本地有 Redis 和 MySQL。然后git clone https://gitcode.com/gh_mirrors/one/one-api cd one-api cp config.example.yaml config.yaml把 config.yaml 里的数据库、Redis 连接填好后端go build -o one-api main.go构建web 目录yarn install后yarn dev起前端开发服务器。依赖装不上时go mod tidy基本能解决想要热重载装好 air 后一条air命令跑起来。先读代码再动手目录结构不复杂弄懂这五块就明白八成目录管什么providers/模型提供商实现OpenAI、Gemini、Claude 等每家一个子目录relay/请求中继逻辑接单、选渠道、转发、回结果controller/各 HTTP 接口的业务逻辑model/数据模型与 GORM 操作迁移逻辑在这里web/src/React 前端views/ 放页面ui-component/ 放公共组件另外还有 router/ 负责组装路由你加接口时从这里进。三个高频改动点新模型接入位置新增一个 provider 就是三步在 providers/ 下建子目录比如 providers/newmodel/实现 providers/base/interface.go 定义的接口再到 providers/providers.go 里注册。顺序别反——先写实现再注册否则路由找不到它。新增接口的写法先在 router/api-router.go 注册路由再去 controller/ 对应文件写业务逻辑涉及读写库就用 model/ 包。要加新表就补 model/migrate.go 的迁移配置项要暴露给用户记得 config.yaml 模板和 common/config/config.go 里的结构体保持同步。前端页面定制与构建页面级改动都在 web/src/views/一个页面一个目录公共组件放 ui-component/。改完用yarn dev热更验证满意后yarn build出产物。验证与上线先go test ./...跑单测确认没改坏然后后端go build、前端yarn build各自出产物。Docker 一键上线不想手动装环境的话docker build -t one-api .之后docker-compose up -d一步拉起 。上线后数据库连不上先查 config.yaml 的连接信息。部署细节、环境变量、升级说明都在 部署文档 和 环境变量说明 里。收尾与资源一句话收束One Hub 的模型层在 providers、中继层在 relay、页面在 web/src二次开发路径很清晰。剩下就看 更新说明 和 模型提供商实现 这两处照着改就行。【免费下载链接】one-apiOpenAI 接口管理 分发系统改自songquanpeng/one-api。支持更多模型加入统计页面完善非openai模型的函数调用。项目地址: https://gitcode.com/gh_mirrors/one/one-api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考