OpenAI
此頁面由機器翻譯。查看原始英文文章

Assistants API v2 的推出會如何影響我使用 API v1 啟用的 Assistants?

Playground、成本與遷移的影響

更新日期:4 days ago

截至 2025 年 3 月 11 日,我們已發布全新智慧體平台的建構元件。如需詳細資訊,請參閱我們的 Responses API API 文件、包括 網頁搜尋檔案搜尋電腦使用在內的工具,以及我們含有 追蹤功能的 智慧體 SDK

  • 不會自動升級:您目前的助理、執行緒和執行作業不會自動遷移至 v2。除非您選擇手動遷移,否則仍可透過 v1 API 存取及使用這些項目。

  • 可存取兩個版本:您可完整存取 v1 和 v2 API。這表示您可以繼續對現有助理使用 v1,也可以探索 v2 提供的新功能與改良。

  • Token 用量差異:v1 與 v2 的 Token 用量可能有所不同,尤其是 file_search 和 retrieval 等工具。相較於 v1 的 retrieval 工具,v2 的 file_search 工具通常平均耗用較少 Token;如有需要,您仍可透過 v1 版本標頭使用舊版 retrieval 工具。

  • 遷移選項:Playground 使用者介面和新版 SDK 會使用 v2 API,而 Assistants API 請求必須包含 OpenAI-Beta: assistants=v2 標頭。Assistants API v1 已淘汰;所有仍在使用的 v1 整合項目都應遷移至 v2。如需進一步瞭解如何從 Assistants v1 遷移至 v2,請參閱這份遷移指南

這篇文章有幫助嗎?