OpenAI
页面内容为机器翻译。查看英文原文

Assistants API v2 的发布会如何影响我使用 API v1 启动的 Assistants?

对 Playground、成本和迁移的影响

更新于:4 days ago

截至 2025 年 3 月 11 日,我们已发布新智能体平台的构建模块。如需了解详情,请参阅我们的 API 文档:Responses 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;助手 API 请求必须包含 OpenAI-Beta: assistants=v2 标头。助手 API v1 已弃用;所有仍在使用 v1 的集成都应迁移到 v2。如需进一步了解如何从助手 v1 迁移到 v2,请参阅此迁移指南

这篇文章对你有帮助吗?