该版本为API增加了提示缓存诊断功能，修正了函数调用完成事件字段，并修复了网络搜索状态处理与服务器重试延迟溢出等问题。
AI解读：这次更新对使用OpenAI API的开发者来说，最直接的价值在于新增的提示缓存诊断功能。提示缓存能降低重复请求的成本和延迟，此前开发者很难判断缓存是否生效，现在通过SDK的响应中可以获取相关诊断信息，从而优化自己的调用策略。同时，v3.9.0修正了函数调用完成事件中的字段，让事件数据与API规范保持一致；并修复了不完整网络搜索状态处理和服务器重试延迟溢出的问题，后者能防止因极端延迟值导致的重试机制故障。对普通用户而言，如果已在运行基于OpenAI的Python应用，升级到 3.9.0 应当是一个低风险的选择，特别是如果你依赖函数调用或处理大量网络搜索请求。
2026 年 9 月 5 日，OpenAI Python SDK发布v3.9.0。新版本新增提示缓存诊断功能，允许开发者在API调用中查看缓存命中相关信息；同时修正了函数调用完成事件字段，使其与OpenAI API规范一致。
修复与文档更新
该版本修复了两个影响可靠性的问题：一是接受不完整的网络搜索调用状态，此前SDK可能将这类状态视为错误；二是拒绝服务器重试延迟溢出的情况，避免因过大的延迟值引发异常。
此外，v3.9.0更新了API文档，补充了限流和模型过载响应的说明；SDK依赖的底层工具迁移到forked steady分支。