最終更新日: 2025-05-14
利用上の注意
このポストは Microsoft 社の Azure 公式ドキュメント(CC BY 4.0 または MIT ライセンス) をもとに生成AIを用いて翻案・要約した派生作品です。 元の文書は MicrosoftDocs/azure-ai-docs にホストされています。
生成AIの性能には限界があり、誤訳や誤解釈が含まれる可能性があります。 本ポストはあくまで参考情報として用い、正確な情報は必ず元の文書を参照してください。
このポストで使用されている商標はそれぞれの所有者に帰属します。これらの商標は技術的な説明のために使用されており、商標権者からの公式な承認や推奨を示すものではありません。
変更内容のハイライトは、Azure OpenAI API関連のドキュメントに対する軽微な更新であり、主にAPIバージョンの非推奨やプレビューリリースの日付の更新、新機能の追加について言及しています。また、非推奨バージョンのAPIの使い方に関連する情報も更新されています。
GPT-image-1、評価API、o3およびo4-miniの推論要約追加特筆すべき破壊的変更はなし。
2025年4月1日に更新Azure OpenAIサービスに関する最新の情報を開発者に提供し、APIの使用に関して最新の機能と推奨事項を受け取ることで、開発者がより効果的に作業を進められるように配慮されています。
この更新は、特に最新推論プレビューにおけるAPIの進化を示すものであり、開発者にとって更新された機能やエンドポイントを理解し、活用するために重要です。新しいプレビューリリースでは、GPT-image-1や評価APIの機能が追加され、開発者がAzureのAI機能をより豊かに利用できるようになったことが示されています。
また、Azure API ManagementとOpenAPI 3.1の互換性に関する既知の問題に触れることで、開発者がAPI仕様を正しく理解し、適切に解析するための実践が促されています。これにより、実際のアプリケーションに新機能を組み込む際に役立つ情報が提供され、全体的にAzure OpenAIサービスの価値を高める役割を果たしていることがわかります。
| Filename | Type | Title | Status | A | D | M |
|---|---|---|---|---|---|---|
| api-version-deprecation.md | minor update | APIバージョンの非推奨に関する更新 | modified | 12 | 3 | 15 |
| api-surface.md | minor update | APIサーフェスの更新 | modified | 1 | 1 | 2 |
| latest-inference-preview.md | minor update | 最新推論プレビューのAPIバージョン更新 | modified | 538 | 400 | 938 |
@@ -18,17 +18,20 @@ This article is to help you understand the support lifecycle for the Azure OpenA
> [!NOTE]
-> New API response objects may be added to the API response without version changes. We recommend you only parse the response objects you require.
+> New API response objects may be added to the API response without version changes. We recommend you only parse the response objects you require.
+>
+> The latest Azure OpenAI spec uses OpenAPI 3.1. It is a known issue that this is currently not fully supported by [Azure API Management](/azure/api-management/api-management-key-concepts)
## Latest preview API releases
Azure OpenAI API latest release:
-- Inference: [2025-03-01-preview](reference-preview.md)
-- Authoring: [2025-03-01-preview](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/cognitiveservices/data-plane/AzureOpenAI/authoring/preview/)
+- Inference: [2025-04-01-preview](reference-preview.md)
+- Authoring: [2025-04-01-preview](authoring-reference-preview.md)
This version contains support for the latest Azure OpenAI features including:
+- `GPT-image-1`, the evaluations API, reasoning summary with `o3` and `o4-mini` . [**Added in 2025-04-01-preview**]
- [Responses API & support for `computer-use-preview` model](./how-to/responses.md) [**Added in 2025-03-01-preview**]
- [Stored Completions (distillation) API](./how-to/stored-completions.md#stored-completions-api) [**Added in 2025-02-01-preview**]
- [Predicted Outputs](./how-to/predicted-outputs.md) [**Added in 2025-01-01-preview**]
@@ -44,6 +47,12 @@ This version contains support for the latest Azure OpenAI features including:
- [Function calling](./how-to/function-calling.md) [**Added in 2023-07-01-preview**]
- [Retrieval augmented generation with your data feature](./use-your-data-quickstart.md). [**Added in 2023-06-01-preview**]
+## Changes between 2025-04-01-preview and 2025-03-01-preview
+
+- [`GPT-image-1` support](/azure/ai-services/openai/how-to/dall-e)
+- [Reasoning summary for `o3` and `o4-mini`](/azure/ai-services/openai/how-to/reasoning)
+- [Evaluation API](/azure/ai-services/openai/authoring-reference-preview#evaluation---create)
+
## Changes between 2025-03-01-preview and 2025-02-01-preview
- [Responses API](./how-to/responses.md){
"modification_type": "minor update",
"modification_title": "APIバージョンの非推奨に関する更新"
}この変更は、「articles/ai-services/openai/api-version-deprecation.md」ファイルに対するもので、Azure OpenAI APIの最新のプレビューリリースに関する情報を更新しています。主な変更点は、プレビューリリースの日付の更新と、それに関連する新しい機能の追加についての詳細が含まれています。
具体的には、以前は2025年3月1日がリリースされた日時だったのが、2025年4月1日プレビューへの更新が行われました。また、GPT-image-1や評価API、o3およびo4-miniの推論要約といった新機能が追加されたことが記述されています。
この変更は、Azure API Managementが現在、OpenAPI 3.1を完全にはサポートしていないという既知の問題にも言及しており、ユーザーがAPIの応答オブジェクトを適切に解析する際の推奨事項を強調しています。全体として、この更新はAPIのサポートライフサイクルに関する重要な情報を提供し、開発者が新機能を利用する際に有益な内容となっています。
@@ -22,7 +22,7 @@ Each API surface/specification encapsulates a different set of Azure OpenAI capa
| API | Latest preview release | Latest GA release | Specifications | Description |
|:---|:----|:----|:----|:---|
| **Control plane** | [`2024-06-01-preview`](/rest/api/aiservices/accountmanagement/operation-groups?view=rest-aiservices-accountmanagement-2024-06-01-preview&preserve-view=true) | [`2024-10-01`](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2024-10-01&tabs=HTTP&preserve-view=true) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/resource-manager/Microsoft.CognitiveServices) | Azure OpenAI shares a common control plane with all other Azure AI Services. The control plane API is used for things like [creating Azure OpenAI resources](/rest/api/aiservices/accountmanagement/accounts/create?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true), [model deployment](/rest/api/aiservices/accountmanagement/deployments/create-or-update?view=rest-aiservices-accountmanagement-2023-05-01&tabs=HTTP&preserve-view=true), and other higher level resource management tasks. The control plane also governs what is possible to do with capabilities like Azure Resource Manager, Bicep, Terraform, and Azure CLI.|
-| **Data plane - authoring** | `2025-04-01-preview` | `2024-10-21` | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/authoring) | The data plane authoring API controls [fine-tuning](/rest/api/azureopenai/fine-tuning?view=rest-azureopenai-2024-08-01-preview&preserve-view=true), [file-upload](/rest/api/azureopenai/files/upload?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true), [ingestion jobs](/rest/api/azureopenai/ingestion-jobs/create?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true), [batch](/rest/api/azureopenai/batch?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true) and certain [model level queries](/rest/api/azureopenai/models/get?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true)
+| **Data plane - authoring** | [`2025-04-01-preview`](/azure/ai-services/openai/authoring-reference-preview) | `2024-10-21` | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/authoring) | The data plane authoring API controls [fine-tuning](/rest/api/azureopenai/fine-tuning?view=rest-azureopenai-2024-08-01-preview&preserve-view=true), [file-upload](/rest/api/azureopenai/files/upload?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true), [ingestion jobs](/rest/api/azureopenai/ingestion-jobs/create?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true), [batch](/rest/api/azureopenai/batch?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true) and certain [model level queries](/rest/api/azureopenai/models/get?view=rest-azureopenai-2024-08-01-preview&tabs=HTTP&preserve-view=true)
| **Data plane - inference** | [`2025-04-01-preview`](/azure/ai-services/openai/reference-preview#data-plane-inference) | [`2024-10-21`](/azure/ai-services/openai/reference#data-plane-inference) | [Spec files](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cognitiveservices/data-plane/AzureOpenAI/inference) | The data plane inference API provides the inference capabilities/endpoints for features like completions, chat completions, embeddings, audio, on your data, Dall-e, assistants, etc. |
## Authentication{
"modification_type": "minor update",
"modification_title": "APIサーフェスの更新"
}この変更は、「articles/ai-services/openai/includes/api-surface.md」ファイルに対するもので、Azure OpenAIAPIに関する最新のプレビューリリース情報と使用可能なAPIの概要を更新しています。具体的には、「Data plane - authoring」セクションにおいて、プレビューリリースの日付を2025-04-01-previewに修正しました。
この変更に伴い、関連リンクも更新されており、ユーザーが新しいプレビューリリースにアクセスしやすくなっています。全体として、この更新はAzure OpenAI のAPIがどのように進化しているのかを反映しており、開発者が最新情報に基づいて作業できるようにするための重要な情報を提供しています。シンプルな修正ではありますが、API仕様や機能の正確な理解を助ける役割を果たしています。
{
"modification_type": "minor update",
"modification_title": "最新推論プレビューのAPIバージョン更新"
}この変更は、「articles/ai-services/openai/includes/api-versions/latest-inference-preview.md」ファイルに対するもので、Azure OpenAIの最新の推論プレビューAPIバージョンに関する情報を大幅に更新しています。具体的には、538行が追加され、400行が削除され、合計で938行の変更が行われています。
この改訂では、最新のAPIの機能やエンドポイントに関する詳細情報が追加された結果、全体的な内容がより充実し、開発者が必要とする最新の技術情報にアクセスしやすくなっています。特に、APIの更新に伴う新しい機能や改善点が反映されており、開発者がその情報を活用して効果的に作業できるように設計されています。
全体として、この更新は、Azure OpenAIサービスにおける推論機能の進化を示す重要なものであり、開発者が新しい機能を正しく享受できるように最新情報を提供する役割を果たしています。