向后兼容性
OpenAI 致力于通过尽可能避免主要 API 版本中的中断性变更来为 API 用户提供稳定性。这包括:
随着时间的推移,将持续提供向后兼容的更改和升级。这些和任何罕见的重大更改都将在更改日志中传达。以下是一些我们认为是向后兼容(非中断性)更改的更改示例。
快照之间模型提示行为的更改
模型输出本质上是变量,因此快照之间的提示和模型行为应该会发生变化。例如,如果您从gpt-4o-2024-05-13
自gpt-4o-2024-08-06
一样system
或user
消息在不同版本之间的功能可能有所不同。确保一致的提示行为和模型输出的最佳方法是使用固定的模型版本,并为您的应用程序实现 eval。
向后兼容的 API 更改
- 向 REST API 和 SDK 添加新资源 (URL)
- 添加新的可选 API 参数
- 向 JSON 响应对象或事件数据添加新属性
- 更改 JSON 响应对象中的属性顺序
- 更改不透明字符串(如资源标识符和 UUID)的长度或格式
- 添加新的事件类型(在流式处理或 Realtime API 中)