openai-python v2.15.0更新：新增Response完成時(shí)間屬性、語(yǔ)音模型擴(kuò)展、GPT Image升級(jí)等功能詳解

2026年1月10日，openai-python迎來(lái)了最新版本v2.15.0。該版本由自動(dòng)化代碼生成系統(tǒng)發(fā)布，包含重要的功能更新與內(nèi)部?jī)?yōu)化，是一次面向開(kāi)發(fā)者的實(shí)用增強(qiáng)升級(jí)。以下為詳細(xì)更新內(nèi)容及代碼層面變化解析。

一、版本概覽

• ?版本號(hào)：2.15.0

• ?發(fā)布日期：2026年1月10日

• ?主要提交：

• • ?feat(api): add new Response completed_at prop

  • ?chore(internal): codegen related update

  • ?release: 2.15.0

本次更新共有3次提交、26個(gè)文件被修改，由自動(dòng)化bot完成發(fā)布。

二、核心功能更新 1. 新增 Response 的completed_at屬性

在類型文件src/openai/types/responses/response.py中新增了completed_at字段，用于表示 Response 完成的時(shí)間戳。
.

completed_at: Optional[float] = None
"""
Unix timestamp (in seconds) of when this Response was completed.
Only present when the status is completed.
"""

這一更新使開(kāi)發(fā)者能夠精確追蹤響應(yīng)的完成時(shí)間，方便對(duì)話記錄、系統(tǒng)日志及數(shù)據(jù)分析。

2. 新增語(yǔ)音模型與語(yǔ)音參數(shù)調(diào)整

本次版本對(duì)多處與語(yǔ)音合成（Speech、ChatCompletion Audio、Realtime Audio）相關(guān)的文件進(jìn)行了改進(jìn)，統(tǒng)一了語(yǔ)音列表描述方式，并新增了兩個(gè)新內(nèi)置聲音：
marin與cedar。

更新涉及文件如下：

• ?src/openai/resources/audio/speech.py

• ?src/openai/types/audio/speech_create_params.py

• ?src/openai/types/chat/chat_completion_audio_param.py

• ?src/openai/types/realtime/realtime_audio_config_output.py

• ?src/openai/types/realtime/realtime_audio_config_output_param.py

• ?src/openai/types/realtime/realtime_response_create_audio_output.py

• ?src/openai/types/realtime/realtime_response_create_audio_output_param.py

更新后的語(yǔ)音選項(xiàng)包括：
.

alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse, marin, cedar

描述也改為統(tǒng)一格式：

Supported built-in voices are … Previews of the voices are available in the Text to Speech guide.

這一優(yōu)化為語(yǔ)音生成場(chǎng)景提供更多聲音選擇，顯著提升了個(gè)性化與音質(zhì)表現(xiàn)。

3. GPT 圖像模型全面升級(jí)

在src/openai/resources/images.py中的說(shuō)明中，新增了GPT Image 1.5與GPT Image 1-mini模型支持，官方表述修改為：

This endpoint supports GPT Image models (gpt-image-1.5, gpt-image-1, and gpt-image-1-mini) and dall-e-2.

這意味著圖像編輯與生成接口的靈活性進(jìn)一步提升，兼容更多模型版本。

4. 工具選擇參數(shù)優(yōu)化（tool_choice）

在多個(gè)文件中（如src/openai/resources/responses/input_tokens.py、src/openai/types/responses/input_token_count_params.py）重新定義了tool_choice字段的描述，使其更為簡(jiǎn)潔與直觀：

由：

How the model should select which tool (or tools) to use when generating a response.

更新為：

Controls which tool the model should use, if any.

這一修改提升了文檔清晰度，使開(kāi)發(fā)者更容易理解工具選擇機(jī)制。

5. 新增加密內(nèi)容參數(shù)（compaction item）

在以下三個(gè)文件中增加了對(duì)encrypted_content字段的說(shuō)明：

• ?src/openai/types/responses/response_compaction_item.py

• ?src/openai/types/responses/response_compaction_item_param.py

• ?src/openai/types/responses/response_compaction_item_param_param.py

新增描述：

“The encrypted content of the compaction summary.”

此更新用于支持對(duì)話壓縮（Compaction）項(xiàng)的加密內(nèi)容描述，增強(qiáng)了安全性與數(shù)據(jù)完整性。

6. 新增 Code Interpreter 容器內(nèi)存限制參數(shù)

在src/openai/types/responses/tool.py與src/openai/types/responses/tool_param.py中新增字段：
.

memory_limit: Optional[Literal["1g", "4g", "16g", "64g"]]
"""The memory limit for the code interpreter container."""

開(kāi)發(fā)者可通過(guò)該參數(shù)控制代碼執(zhí)行容器的內(nèi)存上限，適用于需要特殊資源占用的任務(wù)場(chǎng)景。

7. Web 搜索函數(shù)優(yōu)化與參數(shù)擴(kuò)展

文件：

• ?src/openai/types/responses/response_function_web_search.py

• ?src/openai/types/responses/response_function_web_search_param.py

更新內(nèi)容：

• ? 原query參數(shù)標(biāo)記為[DEPRECATED]

• ? 新增queries支持多關(guān)鍵詞搜索

• ? 增加sources字段列表，用于返回搜索來(lái)源。

這標(biāo)志著搜索功能接口設(shè)計(jì)更趨靈活，兼容多維查詢場(chǎng)景。

8. 其他文件變動(dòng)摘要

• ?LICENSE文件更新年份至 2026。

• ?CHANGELOG.md增加新版本日志與提交記錄。

• ?pyproject.toml與_version.py版本號(hào)提升至 2.15.0。

• ?.stats.yml更新 OpenAPI 規(guī)范 URL 與哈希。

• ?.release-please-manifest.json更新標(biāo)識(shí)。

內(nèi)部代碼生成系統(tǒng)進(jìn)行了更新（代碼生成相關(guān)），優(yōu)化了自動(dòng)化生成流程，確保類型文件同步最新 OpenAPI 規(guī)范：

提交記錄：

chore(internal): codegen related update

該更新確保整個(gè) Python SDK 與平臺(tái) API 規(guī)范持續(xù)保持一致。

四、總結(jié)

代碼地址：github.com/openai/openai-python

openai-python v2.15.0 是一次重要的維護(hù)與功能增強(qiáng)版本，重點(diǎn)包括：

• ?Response新增 completed_at 屬性，支持響應(yīng)結(jié)束時(shí)間追蹤。

• ?語(yǔ)音模型擴(kuò)展，新增 marin 與 cedar 聲音選項(xiàng)。

• ?圖像編輯接口支持 GPT Image 1.5 與 mini 模型。

• ?工具選擇參數(shù)描述簡(jiǎn)化，文檔更清晰。

• ?Code Interpreter 增加內(nèi)存限制設(shè)置。

• ?Web 搜索功能優(yōu)化，支持多關(guān)鍵詞與來(lái)源返回。

• ?系統(tǒng)內(nèi)部代碼生成與OpenAPI規(guī)范全面更新。

我們相信人工智能為普通人提供了一種“增強(qiáng)工具”，并致力于分享全方位的AI知識(shí)。在這里，您可以找到最新的AI科普文章、工具評(píng)測(cè)、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來(lái)發(fā)展。