Events
May 19, 6 PM - May 23, 12 AM
Calling all developers, creators, and AI innovators to join us in Seattle @Microsoft Build May 19-22.
Register todayAzure OpenAI API preview lifecycle
This article is to help you understand the support lifecycle for the Azure OpenAI API previews. New preview APIs target a monthly release cadence. Whenever possible we recommend using either the latest GA, or preview API releases.
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.
Azure OpenAI API latest release:
- Inference: 2025-03-01-preview
- Authoring: 2025-03-01-preview
This version contains support for the latest Azure OpenAI features including:
- Responses API & support for
computer-use-previewmodel [Added in 2025-03-01-preview] - Stored Completions (distillation) API [Added in 2025-02-01-preview]
- Predicted Outputs [Added in 2025-01-01-preview]
- Reasoning models [Added in 2024-12-01-preview]
- Stored completions/distillation [Added in 2024-12-01-preview]
- Assistants V2 [Added in 2024-05-01-preview]
- Embeddings
encoding_formatanddimensionsparameters [Added in 2024-03-01-preview] - Assistants API. [Added in 2024-02-15-preview]
- Text to speech. [Added in 2024-02-15-preview]
- DALL-E 3. [Added in 2023-12-01-preview]
- Fine-tuning. [Added in 2023-10-01-preview]
- Whisper. [Added in 2023-09-01-preview]
- Function calling [Added in 2023-07-01-preview]
- Retrieval augmented generation with your data feature. [Added in 2023-06-01-preview]
- Stored completions (distillation) API support.
predictionparameter added for predicted outputs support.gpt-4o-audio-previewmodel support.
store, andmetadataparameters added for stored completions support.reasoning_effortadded for latest reasoning models.user_security_contextadded for Microsoft Defender for Cloud integration.
max_completion_tokensadded to supporto1-previewando1-minimodels.max_tokensdoes not work with the o1 series models.parallel_tool_callsadded.completion_tokens_details&reasoning_tokensadded.stream_options&include_usageadded.
- Structured outputs support.
- Large file upload API added.
- On your data changes:
- Mongo DB integration.
role_informationparameter removed.rerank_scoreadded to citation object.- AML datasource removed.
- AI Search vectorization integration improvements.
- Batch API support added
- Vector store chunking strategy parameters
max_num_resultsthat the file search tool should output.
- Assistants v2 support - File search tool and vector storage
- Fine-tuning checkpoints, seed, events
- On your data updates
- DALL-E 2 now supports model deployment and can be used with the latest preview API.
- Content filtering updates
- Breaking Change: Enhancements parameters removed. This impacts the
gpt-4Version:vision-previewmodel. - timestamp_granularities parameter added.
audioWordobject added.- Additional TTS
response_formats: wav & pcm.
Azure OpenAI API version 2024-10-21 is currently the latest GA API release. This API version is the replacement for the previous 2024-06-01 GA API release.
We recommend first testing the upgrade to new API versions to confirm there's no impact to your application from the API update before making the change globally across your environment.
If you're using the OpenAI Python or JavaScript client libraries, or the REST API, you'll need to update your code directly to the latest preview API version.
If you're using one of the Azure OpenAI SDKs for C#, Go, or Java, you'll instead need to update to the latest version of the SDK. Each SDK release is hardcoded to work with specific versions of the Azure OpenAI API.