同一家的同一个模型,接口里能填的名字可能有三四个写法,返回的效果却不一样。你可能刚发现上游悄悄换了版本、或者换了个中转站后回答风格变了,却不知道是模型变了还是参数变了。这篇不讲谁强谁弱,只给一条从命名读到实跑验证的查证顺序,让你在半小时内把「这个版本和那个版本差在哪」问清楚。
同一家的同一个模型,接口里能填的名字可能有三四个写法,返回的效果却不一样。你可能刚发现上游悄悄换了版本,或者换了个中转站后回答风格变了,却不知道是模型变了还是参数变了。这篇不讲谁强谁弱,只给一条从命名读到实跑验证的查证顺序,让你在半小时内把「这个版本和那个版本差在哪」问清楚。
前提先说清:版本差异不是每次都要查。只有当你要做基线评测、要留痕、或者结果突然异常时,才值得花这半小时。日常写脚本调 API,多数时候把提示词写稳比锁定版本更有效。
先从模型名的后缀读起
第一眼看名字。带日期后缀的通常是固定快照,指向某一批权重不再变;不带日期的多半是滚动别名,会跟着官方更新走。同一别名今天和下周可能不是同一个权重,这一点很多人踩过坑,用别名做了长期对比,结果前后两批数据其实不可比。
- 带日期的写法一般等于固定快照,适合做基线;不带日期的大概率是滚动别名,行为会漂移
- 先分清「厂商别名」和「平台自定义名」:平台常把上游模型改名托管,名字像不代表同一个版本,要看平台的模型说明页
- 把候选名整理成一张小表:调用名、指向的底层模型、是否固定、文档里写的上下文与模态支持,不清楚的项去站内模型资料库对照
- 命名相似但参数量或量化档不同的两个名字,差别可能比版本差异更大,别把它们混在一起比
| 命名特征 | 大概率含义 | 能不能拿来锁版本 |
|---|---|---|
| 带日期后缀 | 固定快照,指向一批确定的权重 | 能,适合做基线 |
| 无日期短名 | 滚动别名,会随官方更新换指向 | 不建议,今天明天可能不同 |
| 带平台前缀 | 平台自定义托管名,底层可能是上游某版本 | 看平台说明页,名字本身不说明问题 |
| 带规格后缀 | 同系列不同参数量或量化档 | 这不是版本差异,是另一个模型 |
官方口径和托管方口径分头查
名字读完之后,去两个地方对照:官方渠道和你的托管方。官方重点看两处,模型或版本列表页、更新日志。更新日志里「某别名迁移到哪个快照」「某版本弃用时间」这两类说明,比参数表有用得多,因为它直接告诉你指向变了没有。
托管平台要看三处:模型说明页、限流与计费页、公告。同一个模型在不同平台,上下文长度、默认参数、是否默认开启思考,常常不一样。官方和托管方说法冲突时,以实际请求返回的模型标识字段为准。很多接口会在响应里回一个具体版本字符串,那是最硬的证据。
- 模型标识字段
- 接口响应里回的模型名或版本串,比文档描述更接近你实际调到的那个
- 弃用说明
- 更新日志里写某个别名将在某时间后迁移或下线,这是指向要变的信号
- 平台托管名
- 平台自己起的名,底层指向哪个上游版本要翻平台的模型说明页
- 默认参数
- 同名字不同平台默认温度、默认是否思考不一样,会让效果看起来像换了模型
拿不准某个平台是不是真在跑你以为的那个版本,可以去看站内的中转站核验方法和可信度排行,那里有按检测项整理的口径。具体排名和检测数字会变,到 /rankings 核对当时的结果,不要凭印象。
用最小请求做一次对照实验
文档口径对不上的时候,只剩实测这一条路。核心原则是固定一切可变项:同一段提示词、同一温度与最大输出、关掉流式,只改模型名,跑两三组。变量多于一个,结果就说明不了任何问题。
- 固定变量同一提示词、同一温度、同一最大输出、关闭流式,只把模型名当唯一变量。跑之前把这些值记下来,别凭记忆。
- 设计探针用能区分版本的问题,比如知识截止相关提问、严格的格式输出要求、长输入下的截断表现。问「你是谁」基本没用,模型对自己的版本说法经常不准。
- 看四类信号响应里的模型标识、首字延迟与输出速度、报错信息的措辞、长上下文边界处是否正常。四项里有两项不一致,基本可以认定版本不同。
- 留基线把结果存成一行记录:模型名、时间、四项观测。下次变动时才有基线可比,单次结果不作数,换时段再跑一遍更稳。
# 固定变量做对照,只改模型名;两次请求的其余参数保持一致
# 观察响应里的模型标识字段与报错措辞,别只看输出像不像如果你想要更系统的探针设计和评分口径,可以去站内看速度与质量的测试方法,那里讲了怎么把观测项收敛成可比的分数。盯具体分数没意义,分数会变,方法才是你能带走的东西。
哪些情况不用较真版本
不是所有调用都值得追版本。先判断你的任务对版本是否敏感,再决定要不要花时间查。
- 任务输出稳定达标且延迟成本在预算内,比如分类、抽取、格式转换,换没换版本不影响交付,就不必追
- 提示词对格式极度敏感时,该做的是加输出校验和重试,而不是死磕版本号
- 真正需要锁版本的是有合规留痕要求、对可复现要求高、或做了微调与评测基线的场景,这类优先选固定快照并写进配置
- 调用失败或结果突变时,按「参数变了、模型变了、平台限流」的顺序排查,别一上来就归因于版本升级
| 你的场景 | 要不要锁版本 | 理由 |
|---|---|---|
| 内部脚本、一次性任务 | 不用 | 结果达标即可,追版本没有收益 |
| 长期 A/B 对比 | 要 | 基线一变,历史数据就不可比 |
| 合规留痕、可复现要求高 | 要 | 需要能说明每次请求到底调到了哪个快照 |
| 格式敏感的流水线 | 不必锁死 | 加校验与重试比锁版本更划算 |
还有一点:滚动别名的小幅漂移是常态,官方偶尔会说明,更多时候不会。如果你的流程依赖某个别名长期不变,这本身就是个隐患。把固定快照写进配置、把对比记录留好,比每次出问题再回头查要省事得多。
下一步如果你手上有具体模型想核对版本差异,或想知道某个中转站到底在跑什么,去站内的模型资料库和可信度排行查当时的记录,比在群里问一句靠谱。→常见问题
同一个模型名,昨天和今天调用结果不一样,是版本换了吗?
不一定。先排除三件事:温度与随机种子等参数是否一致、上游是否在高峰期做了限流或降级路由、你的提示词上下文有没有变。排除后再对比响应里的模型标识字段和输出速度,两项都对不上才考虑版本滚动。要稳定复现,就改用带日期后缀的固定快照,并在代码配置里写死。
官方文档里的版本号和 API 实际返回的不一致,信哪个?
以 API 返回的模型标识为准,那是一次真实调用产生的。文档可能滞后于一两次发布,或者你查的是别名页而不是快照页。做法是把接口返回的标识记下来,再回站内模型库和官方更新说明里对一遍,看这个快照的上下文上限、模态支持和弃用时间。三者能对上就没有疑问。
怎么判断一个中转站跑的到底是不是它标称的那个版本?
没法百分百确认,只能交叉验证。用固定提示词跑探针,看响应里的模型标识、输出速度区间、长上下文边界表现是否与官方渠道同版本接近;再查它的模型说明页有没有写清指向的快照与限制。差距明显就降级使用或换家。站内中转站目录、可信度排行与在线实测页可以先过一遍再决定要不要接。