OpenAI Python SDK v3.4.0发布：新增项目驻留配置与成本计量单位，修复多项Azure与WebSocket问题
新版本为ChatCompletionChunk增加混淆字段，并引入项目驻留配置和成本数量单位；同时修复Azure部署名称编码、WebSocket重定向源检查等问题。
AI解读：OpenAI Python SDK 3.4.0主要面向两类用户：一是通过Azure部署OpenAI服务的团队，他们此前可能遇到部署名称编码不一致或认证模式冲突的问题，本次更新统一了编码并保留认证边界；二是需要精细核算成本的开发者，新增的成本数量单位（cost quantity units）允许更准确地计量API调用费用，而项目驻留配置（project residency configuration）则帮助满足数据驻留合规要求。此外，ChatCompletionChunk新增的混淆（obfuscation）字段可能是为敏感内容过滤提供支持。对大多数普通开发者而言，升级到 3.4.0 不需要立即行动，但如果你正在使用Azure或WebSocket连接，建议及时更新以获得修复和安全增强。
OpenAI Python SDK v3.4.0于 2026 年 8 月 25 日发布。该版本新增两个API功能：为ChatCompletionChunk添加obfuscation字段（PR #3690），以及引入项目驻留配置和成本数量单位（PR #3726）。
关键修复针对Azure与WebSocket连接
本次更新包含多项针对Azure集成的修复：统一部署名称的编码方式（#3683）、保留Azure认证边界跨传输层（#3684）、解决一个认证模式问题（#3689）、并确保provider验证错误不携带敏感值（#3691）。
WebSocket相关修复包括：对重定向执行一致的源（origin）检查（#3693），以及刷新时保留发送队列的字节计数（#3688）。此外，还修复了登录时保留配置的TLS主机名（#3694）和SSE解码不限制事件大小（#3687）。
内部重构与文档更新
版本包含多项重构，如隔离音频响应格式选择、向量存储轮询助手、文件处理轮询至SDK拥有的助手，以及共享嵌入响应解码和Webhook签名验证（#3699、#3701、#3704、#3712、#3713）。
文档方面，恢复了生成的ChatKit API索引（#3705），并标准化了Python SDK漏洞披露政策（#3642）。