One API 模型映射教程3 步让任意模型名转发到真实渠道【免费下载链接】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应用代码里写死了gpt-3.5但你的渠道上实际挂的是gpt-35-turbo-0613请求一发出去就是无可用渠道。改客户端代码不现实——接入方可能有几十个。One API 的模型映射功能就是为这种场景准备的在渠道上配一条映射规则转发前自动把模型名改掉对上游和下游都透明。模型映射配置步骤整个配置只发生在渠道编辑页3 步就能跑通进入后台渠道管理点进目标渠道的编辑。找到模型映射关系输入框表单定义在 渠道编辑组件填入 JSON用户请求的模型名: 实际转发给渠道的模型名。确认该渠道的模型列表里包含用户会请求的那个原模型名保存。映射关系长这样就是一个键值对{gpt-3.5: gpt-35-turbo-0613}保存后发一条最小请求验证。注意model里填的是原模型名curl http://localhost:3000/v1/chat/completions \ -H Authorization: Bearer sk-你的key \ -H Content-Type: application/json \ -d {model:gpt-3.5,messages:[{role:user,content:hi}]}如果上游正常应答说明改名生效了。请求进来后发生了什么把 One API 理解成一个中转台。请求带着模型名进来中转台先查表这个用户的分组下谁能接这个模型这一步在 渠道选择中间件 里完成按「分组 模型名」挑出可用渠道同优先级的渠道之间随机选一个。有个容易忽略的点这一步用的是原始模型名。也就是说渠道的模型列表里必须写用户请求的那个名字。只写映射目标名这个渠道永远选不中。选中渠道后请求进入转发层。真正转发前One API 会查该渠道配置的模型映射表命中就把请求体里的模型名换掉。核心逻辑只有几行在 模型名映射函数mappedModelName : mapping[modelName] if mappedModelName ! { return mappedModelName, true }换名后的请求才发往上游。原始名保留在OriginModelName改名后的记在ActualModelName两个字段并存于 转发元信息结构。响应回来时原样透传客户端完全感知不到中间发生过替换。模型映射不生效怎么排查报错当前分组下对于模型 X 无可用渠道根因几乎都是渠道模型列表漏配。映射只负责转发时改名渠道选择阶段认的是原模型名列表里没有它渠道就不可见。解法很简单把用户请求的模型名加进该渠道的模型列表再试一次。配置了映射发出去的仍是原模型名根因是model_mapping的 JSON 不合法。解析失败时系统会打日志failed to unmarshal model mapping for channel %d见 渠道模型映射解析然后按无映射处理请求原样透传。解法检查引号、逗号、花括号是否完整前端表单的校验规则就是必须是有效的 JSON 字符串。按日志里的渠道号找到对应渠道修正后保存。改完映射要过一会儿才生效根因是渠道清单会周期性从数据库加载进内存渠道缓存同步 中的SyncChannelCache渠道选择读的是内存快照而不是数据库。解法等一个缓存同步周期等不及就重启服务立即全量刷新。计费对不上预期根因是倍率、价格都按模型名查表而映射发生在转发和计费之前计费日志里记录的是改名后的模型。如果你只给原模型名配了倍率计费就会走到兜底逻辑。解法配置模型倍率时用渠道实际接收的那个模型名去配。进阶建议映射 优先级做降级️主渠道设高优先级备渠道设 0。两条渠道都配同一套映射对外暴露同一个模型名主渠道挂了自动落到备渠道客户端无感知。用日志定位选了谁渠道选择时会输出 debug 日志using channel #%d见 渠道选择中间件配合 日志模块 的输出能直接看到请求最终落到了哪个渠道。映射规则保持精简映射查询是内存 map 查找性能不是瓶颈但规则堆多了之后排查和接手成本会明显上升。建议每条渠道只映射它真实提供的那几个模型废弃的映射定期清掉。下次再看到无可用渠道先别急着改客户端——检查渠道模型列表和映射表原名在列表里、映射能命中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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考