次の方法で共有


Azure AI Foundry Models API ライフサイクルにおける Azure OpenAI

この記事は、Azure OpenAI API のサポート ライフサイクルを理解するのに役立ちます。

新しい API 応答オブジェクトは、いつでも API 応答に追加できます。 必要な応答オブジェクトのみを解析することをお勧めします。

API の進化

以前は、Azure OpenAI は新しい API バージョンの毎月の更新プログラムを受け取りました。 新機能を利用する場合は、新しい API リリースごとにコードと環境変数を常に更新する必要があります。 また、Azure OpenAI では、OpenAI と Azure OpenAI の間でコードを移行するときにオーバーヘッドが発生した Azure 固有のクライアントを使用する追加の手順も必要になりました。

2025 年 8 月以降、次のサポートを追加する次世代 v1 Azure OpenAI API にオプトインできるようになりました。

  • 最新の機能への継続的なアクセスには、毎月新しい api-versionを指定する必要はありません。
  • より頻繁に起動する新機能により、API のリリース サイクルを高速化します。
  • キーベースの認証を使用する場合、OpenAI と Azure OpenAI の間でスワップするコード変更を最小限に抑えた OpenAI クライアントのサポート。
  • トークン ベースの認証とトークンの自動更新に対する OpenAI クライアントのサポート。別の Azure OpenAI クライアントに依存する必要はありません。現在サポートされているすべての言語に対して追加されます。 この機能のサポートは、PythonTypeScript/JavaScript ライブラリに対して近日追加される予定です。 .NET、Java、Go のサポートは現在プレビュー段階で利用できます。

まだプレビュー段階にある新しい API 呼び出しへのアクセスは、機能固有のプレビュー ヘッダーを渡すことによって制御されます。これにより、API のバージョンをスワップすることなく、必要な機能にオプトインできます。 または、一部の機能は API パスを通じてプレビューの状態を示し、追加のヘッダーは必要ありません。

例 :

  • /openai/v1/evals はプレビュー段階であり、 "aoai-evals":"preview" ヘッダーを渡す必要があります。
  • /openai/v1/fine_tuning/alpha/graders/ はプレビュー段階であり、API パスに alpha があるため、カスタム ヘッダーは必要ありません。

最初の v1 GA API の起動では、推論とオーサリング API 機能のサブセットのみをサポートしています。 近日中に、より多くの機能のサポートが急速に追加される予定です。

コードの変更

最終世代 API

import os
from openai import AzureOpenAI

client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2025-04-01-preview",
    azure_endpoint="https://YOUR-RESOURCE-NAME.openai.azure.com")
    )

response = client.responses.create(
    model="gpt-4.1-nano", # Replace with your model deployment name 
    input="This is a test."
)

print(response.model_dump_json(indent=2)) 

次世代 API

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),
    base_url="https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"
)

response = client.responses.create(   
  model="gpt-4.1-nano", # Replace with your model deployment name 
  input="This is a test.",
)

print(response.model_dump_json(indent=2)) 
  • OpenAI() クライアントは、 AzureOpenAI()の代わりに使用されます。
  • base_url は Azure OpenAI エンドポイントを渡し、 /openai/v1 はエンドポイント アドレスに追加されます。
  • api-version は v1 GA API で必須のパラメーターではなくなりました。

v1 API のサポート

ステータス

API パス ステータス
/openai/v1/chat/completions 一般公開
/openai/v1/embeddings 一般公開
/openai/v1/evals Preview
/openai/v1/files 一般公開
/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints/{fine_tuning_checkpoint_id}/copy Preview
/openai/v1/fine_tuning/alpha/graders/ Preview
/openai/v1/fine_tuning/ 一般公開
/openai/v1/models 一般公開
/openai/v1/responses 一般公開
/openai/v1/vector_stores 一般公開

ヘッダーをプレビュー

API パス Header
/openai/v1/evals "aoai-evals":"preview"
/openai/v1/fine_tuning/jobs/{fine_tuning_job_id}/checkpoints/{fine_tuning_checkpoint_id}/copy "aoai-copy-ft-checkpoints" : "preview"

v1 プレビュー リリースと 2025-04-01-preview の間の変更

  • v1 プレビュー API
  • ビデオ生成のサポート
  • 新機能 応答 API の機能:
    • リモート モデル コンテキスト プロトコル (MCP) サーバー ツールの統合
    • 非同期バックグラウンド タスクのサポート
    • 暗号化された推論項目
    • イメージの生成

2025-04-01-preview と 2025-03-01-preview の間の変更

2025-03-01-preview と 2025-02-01-preview の間の変更

2025-02-01-preview と 2025-01-01-preview の間の変更

2025-01-01-preview と 2024-12-01-preview の間の変更

  • predictionのサポートのために パラメーターが追加されました。
  • gpt-4o-audio-preview モデルのサポート

2024-12-01-preview から 2024-10-01-preview の間に変更

2024-09-01-preview と 2024-08-01-preview 間の変更

  • max_completion_tokens が、o1-preview モデルと o1-mini モデルをサポートするために、追加されました。 max_tokenso1 シリーズ モデルでは機能しません。
  • parallel_tool_calls が追加されました。
  • completion_tokens_detailsreasoning_tokens を追加しました。
  • stream_optionsinclude_usage を追加しました。

2024-07-01-preview と 2024-08-01-preview API 仕様の間の変更

  • 構造化出力がサポートされます。
  • 大きなファイルのアップロード API が追加されました。
  • データ変更時:
    • Mongo DB が統合されます。
    • role_information パラメーターが削除されました。
    • rerank_score が引用オブジェクトに追加されました。
    • AML データソースが削除されました。
    • AI Search ベクター化の統合が機能強化されます。

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 仕様間の変更

  • 破壊的変更: 機能強化パラメーターが削除されました。 これは、gpt-4 バージョン:vision-preview モデルに影響します。
  • timestamp_granularities パラメーターが追加されました。
  • audioWord オブジェクトが追加されました。
  • 追加の TTS response_formats: wav & pcm

最新の GA API リリース

Azure OpenAI API バージョン 2024-10-21 が、現時点で最新の GA API リリースです。 この API バージョンは、以前の 2024-06-01 GA API リリースに代わるものです。

既知の問題

  • 2025-04-01-preview Azure OpenAI 仕様では OpenAPI 3.1 が使用されています。これは現在、Azure API Management で完全にはサポートされていないという既知の問題です

次のステップ