变体还是别名？一次调用里 model 字段到底填哪个 ID
本文解释在单次 API 调用中，model 字段应填固定变体 ID 还是滚动别名的区别，并提供判断清单。
为什么 model 字段需要区分 ID 类型
在调用 LLM API 时，model 字段通常可以填两种标识：固定变体 ID（如 gpt-4-0613）和滚动别名（如 gpt-4）。它们指向不同的解析逻辑，直接影响请求的确定性和长期稳定性。
- 固定变体 ID：指向某个具体的模型版本，行为固定，不会随时间变化。
- 滚动别名：指向一个“当前推荐”的版本，服务方可能不定期将其指向新的变体。
两种 ID 的核心差异
| 维度 | 固定变体 ID | 滚动别名 |
|------|------------|----------|
| 指向 | 特定版本 | 动态指向最新稳定版 |
| 行为一致性 | 高，可复现 | 可能随服务方更新而变化 |
| 长期可用性 | 可能被废弃 | 通常长期保留 |
| 适用场景 | 需要严格复现、合规审计 | 希望自动获得改进、快速原型 |
判断该填哪一个：检查清单
在单次请求前，按以下顺序自问：
- 这次调用是否需要可复现的结果？
- 是 → 优先固定变体 ID。
- 否 → 可考虑滚动别名。
- 你的应用是否对模型行为变化敏感？
- 是（如结构化输出、严格格式）→ 固定变体 ID。
- 否（如通用对话）→ 滚动别名可能更省心。
- 你能否接受服务方在不通知的情况下切换底层模型？
- 不能 → 固定变体 ID。
- 能 → 滚动别名。
- 你是否需要长期维护同一个调用？
- 是 → 固定变体 ID 可能被废弃，需关注弃用公告；滚动别名则无需频繁改代码。
- 否 → 随意。
- 你的聚合站是否对两种 ID 都支持？
- 确认该聚合站文档中列出的可用 ID 类型，避免填了不支持的格式。
在聚合站场景下的注意点
聚合站通常转发请求到多个上游。此时：
- 固定变体 ID 可能被映射到特定上游的对应版本，行为更可控。
- 滚动别名可能由聚合站决定路由到哪个上游的哪个版本，不确定性更高。
- 如果聚合站支持“贡献 key”模式，上游 key 的可用模型可能影响解析结果，建议优先使用文档中明确列出的 ID。
总结
单次请求的 model 字段没有绝对正确答案。关键是根据你的复现需求、对行为变化的容忍度和维护成本来权衡。固定变体 ID 适合追求稳定和可审计的场景；滚动别名适合希望自动跟进最新版、且能接受一定不确定性的场景。填写前务必查阅所用聚合站的文档，确认支持的 ID 格式。