模型 ID

RouteAPI 模型 ID 是你的应用在 model 字段中填写的名称。它是业务系统与 RouteAPI 之间的公开约定。

为什么需要稳定的模型 ID

• 平台调整模型可用性时，应用代码无需频繁修改。
• 团队可以统一使用一组经过批准的模型名称。
• 日志、计费和告警更容易阅读。
• 不同 SDK 和工具中的客户端配置更简单。

示例

{
  "model": "gpt-4o",
  "messages": [
    { "role": "user", "content": "总结这份文档。" }
  ]
}

model 的值应与 RouteAPI 控制台中当前账户可用的模型 ID 一致。

最佳实践

• 使用控制台中的模型 ID，不要在生产中硬编码临时名称。
• 为不同质量、延迟或成本预期保留不同模型 ID。
• 在生产流程使用前，先验证模型行为。
• 高流量应用变更模型 ID 后，应查看用量日志确认效果。