企业官网建设流程全解析

• LLM 网关
• AI 应用
• 大模型
• 桌面应用
• 后端

Chat2API 是一款免费的 AI 模型代理工具，它让你通过 DeepSeek、GLM、Kimi、MiniMax、Qwen、Z.ai 等官方网页版零成本接入主流 AI 模型。而模型映射是其中最实用的功能之一：你可以把客户端请求的模型名（如gpt-4）自由改写为实际调用的模型（如DeepSeek-V3.2），并支持通配符匹配与指定优选供应商/账号，真正实现"模型名称随心定制"。

为什么需要模型映射？

不同客户端和工具（如 Cline、Roo-Code 等）对模型名称的写法各不相同，而各家供应商的真实模型 ID 也不一样。模型映射解决了三个常见问题：

三步完成第一个模型映射

1. 打开左侧菜单Models（模型管理），切换到Model Mapping（模型映射）选项卡；
2. 点击Add Mapping（添加映射），填写：
   • 请求模型：客户端发起请求时使用的名称，例如gpt-4；
   • 实际模型：下拉选择真正要调用的模型（按供应商分组展示）；
   • 优选供应商 / 优选账号（可选）：不选则自动按负载均衡分配；
3. 添加后顶部会出现黄色"未保存"提示条，点击Save Config（保存配置）生效。

界面上还能按请求名/实际名搜索已有映射，一键恢复默认映射，编辑和删除操作都很直观。相关界面实现在 ModelMappingConfig.tsx。

通配符匹配：一条规则管住一族模型

请求模型字段支持*通配符（大小写不敏感），规则很简单：

• gpt-*→ 匹配所有以gpt-开头的模型（前缀匹配）
• *-turbo→ 匹配所有以-turbo结尾的模型（后缀匹配）
• claude-*-latest→ 匹配claude-开头且-latest结尾的模型
• *→ 匹配一切模型（万能兜底）

⚠️ 两个实用细节：

• 精确映射优先：如果同时存在精确名称映射和通配符映射，Chat2API 优先使用精确匹配，通配符作为兜底；
• 通配符只支持一个*，多个*不会生效。

匹配逻辑可参考 modelMapper.ts。

优选供应商与优选账号：让请求精准落位

每条映射都可以额外指定：

• 优选供应商：请求只发往该供应商，跳过其他家；
• 优选账号：在供应商下进一步锁定某个具体账号（例如配额充足的主力账号）。

处理流程是：请求进入代理后，先按模型名查出映射（精确 → 通配符），取出preferredProviderId/preferredAccountId，再交给负载均衡器在候选账号中定向选择；最后把请求里的模型名替换为actualModel转发给上游。

关键源码位置：

• 映射数据结构：types.ts（requestModel/actualModel/preferredProviderId/preferredAccountId）
• 请求入口读取优选项：chat.ts
• 负载均衡定向选号：loadbalancer.ts

内置默认映射：开箱即用

模型映射表中带 🔒 "内置" 标记的行是系统默认规则（只读，不可编辑删除），例如 DeepSeek 的思考/搜索变体别名：

• deepseek-v4-flash-think→deepseek-v4-flash
• deepseek-v4-pro-search→deepseek-v4-pro
• deepseek-v4-pro-think-search→deepseek-v4-pro

它们全部把优选供应商固定为 DeepSeek，保证这类别名请求稳定路由。默认值定义见 ModelMappingConfig.tsx。

进阶：用管理 API 批量管理映射

如果你习惯脚本化运维，Chat2API 的 Management API 提供映射的增删改查：

• GET /v0/management/model-mappings查询全部映射
• POST /v0/management/model-mappings新增（重名返回 409）
• PUT /v0/management/model-mappings/:model更新
• DELETE /v0/management/model-mappings/:model删除

接口定义位于 modelMappings.ts，调用时需携带管理密钥（可在 Settings 页开启并配置）。

常见问题

Q：映射了模型名，为什么没生效？检查是否点击了顶部的"保存配置"——映射修改是暂存的，保存后才写入生效。

Q：一条请求同时命中精确映射和通配符映射？精确映射永远优先，通配符只在没有精确匹配时兜底。

Q：删掉自定义映射会怎样？请求将按原始模型名继续处理；若该名称不存在于任何供应商的模型列表，代理会返回no_available_account错误。

小结

Chat2API 的模型映射用"请求名 → 实际模型 + 优选供应商/账号"三要素，配合通配符规则，帮你以极低的维护成本统一各客户端的模型命名。只需在 Models 页的 Model Mapping 选项卡里花一分钟配置，即可让模型名称随心定制。🎯

• LLM 网关
• AI 应用
• 大模型
• 桌面应用
• 后端