共用方式為

Azure OpenAI API 預覽生命週期

  • 發行項

本文旨在協助您了解 Azure OpenAI API 預覽版的支援生命週期。 新的預覽版 API 的目標是每月發行一次。 儘可能建議使用最新的 GA 或預覽 API 版本。

注意

新的 API 回應物件可能會新增至 API 回應，而不會變更版本。 我們建議您只剖析所需的回應物件。

最新的預覽 API 版本

Azure OpenAI API 最新的版本：

重要

對於屬於數據平面撰寫 API 的功能，例如批次、微調和助理檔案，請繼續使用 API 版本 2024-10-01-preview 來利用最新的預覽功能。

此版本包含對最新 Azure OpenAI 功能的支援，包括：

2024-12-01-preview 與 2024-10-01-preview 之間的變更

  • store已針對預存完成支援新增的、 和 metadata 參數。
  • reasoning_effort 已針對最新的 推理模型新增 。
  • user_security_context已新增 適用於雲端的 Microsoft Defender整合。

2024-09-01-preview 與 2024-08-01-preview 之間的變更

  • max_completion_tokens 已新增至支援 o1-preview 和 o1-mini 模型。 max_tokens 不適用於 o1 系列 模型。
  • parallel_tool_calls 已新增。
  • completion_tokens_details 和 reasoning_tokens 已新增。
  • stream_options 和 include_usage 已新增。

2024-07-01-preview 與 2024-08-01-preview API 規格之間的變更

  • 結構化輸出支援。
  • 已新增大型檔案上傳 API。
  • 在您的資料變更上：
    • Mongo DB 整合。
    • 已移除 role_information 參數。
    • rerank_score 已新增至引文物件。
    • 已移除 AML 資料來源。
    • AI 搜尋向量化整合改善。

2024-5-01-preview 與 2024-07-01-preview API 規格之間的變更

2024-04-01-preview 與 2024-05-01-preview API 規格之間的變更

2024-03-01-preview 與 2024-04-01-preview API 規格之間的變更

最新的 GA API 版本

Azure OpenAI API 2024-10-21 版目前是最新的 GA API 版本。 此 API 版本會取代先前的 2024-06-01 GA API 版本。

更新 API 版本

我們建議先測試新 API 版本的升級以確認 API 更新不會對您的應用程式產生影響，然後再在您的環境中進行全域變更。

如果您使用的是 OpenAI Python 或 JavaScript 用戶端程式庫或 REST API，則需要將程式碼直接更新到最新的預覽 API 版本。

如果您使用的是其中一個適用於 C#、Go 或 JAVA 的 Azure OpenAI SDK，則需要更新到最新版本的 SDK。 每個 SDK 版本都經過硬式編碼，可與特定版本的 Azure OpenAI API 搭配使用。

下一步