OpenAI于上海时间2026年10月23日04时03分通过GitHub Release发布Python官方SDK openai-python v3.37.0正式版,对应接口published_at为2026-10-22T20:03:54Z,created_at为2026-10-22T19:57:17Z,prerelease为false且draft为false,标签为v3.37.0。对比基线为v3.36.1至v3.37.0,发布说明标题为3.37.0(2026-10-22),发布提交对应比较链接v3.36.1...v3.37.0。仓库归属为OpenAI组织下的公开仓库openai-python,项目定位为OpenAI接口的Python客户端封装,中国开发者可通过公开仓库查看发布页并经PyPI包openai升级验证。本次未声明许可证变更与安全修复,沿用PyPI元数据与版本标签LICENSE确认的Apache-2.0条件。

关键变化

本次为次版本功能更新并明确标注破坏性变更,核心是Decisions相关类型扩展。Live响应模型中问题instructions现可为字符串,或结构化文本、图片、JSON部件列表;直接对该字段做字符串操作前需先判断isinstance是否为str,并补齐结构化形态的处理分支。Decisions请求输入类型同时新增消息角色与工具历史项,使用穷举类型检查的项目需同步更新分支,否则可能在类型检查或运行时遗漏新增形态。发布说明同时确认存量字符串instructions与DecisionInputMessageParam用户消息输入仍受支持,属兼容保留。

功能提交为expand Decisions input and question types,对应编号4158与提交1e45ad1;配套收敛包括保留文件与视频轮询助手对应编号4155、保留上传助手与Live连接默认值对应编号4152,均表述为preserve,未改变对外接口行为;开发依赖仅将astral-sh/setup-uv由10.2.0升至10.3.0,对应编号4109,仅影响持续集成环境。

兼容性与访问条件

本次主要面向已通过Python对接OpenAI响应、实时、文件、上传与向量能力的开发者与团队,特别是使用Decisions、Live响应与结构化问题指令的工程,需优先评估破坏性类型影响。兼容性方面,PyPI元数据显示需要Python 3.10及以上,分类器覆盖3.10至3.14,许可证为Apache Software License,安装沿用pip install openai,可按标签v3.37.0固定验证。SDK本身公开获取,国内下载需自行解决GitHub与PyPI网络可达性,实际调用仍需配置API密钥或工作负载身份,并以账户权限与后端服务开通状态为准。

限制与下一步

SDK仅完成客户端封装,不改变服务端模型可用范围、配额、限流、价格、区域与内容策略,文件轮询、视频轮询、上传与Live能力能否生效取决于服务端是否已向当前账户开放。开放SDK不等于开放模型权重,模型本身许可仍以官方模型说明为准。本文不对安全性、长期维护与后续兼容作超出发布说明的保证,也未提供性能或成功率对比数据。已接入项目可先在预发环境将版本固定至v3.37.0,回归Decisions问答、工具历史、文件上传与Live连接链路,重点验证instructions分支判断与穷举类型覆盖,确认无回归后再全量升级。后续进展以同一仓库发布页与PyPI历史为准,不以搜索片段或转载为准。