踩坑记录
同名不同版本:模型名称里的三个陷阱
Easycha 编辑部
#模型命名#版本#识别
同一个模型在不同站点上有四五种写法:官方 id、去掉日期后缀的简称、加 -latest 的滚动别名、以及带量化标记的变体。对使用者来说,这些写法背后的行为差异可能很大。
三个常见陷阱:一是滚动别名,指向的版本会随时间变化,今天跑通的提示词下个月可能失效;二是日期后缀被省略,站点实际提供的是旧版本,价格却按新版收;三是量化标记被隐藏,参数规模没变但精度下降,长链推理的失败率上升。
应对方式是把模型 id 写死在配置里,并在每次升级时跑一遍回归集。目录页在展示模型时优先使用 catalog 里的标准 id,遇到站点自建别名会单独标注,方便比对。名称是契约的一部分,不该被当成营销文案。
最后给一条工程建议:在网关层维护一份「模型 id 映射表」,把业务别名映射到站点真实 id,升级时只改映射不改代码。这份表同时可以作为与站点沟通的凭据,避免各说各话。
如果站点拒绝提供确切 id,至少要求它在文档里写明版本日期与是否量化,并把这条要求写进采购评审项。