Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Dit artikel is bedoeld om inzicht te krijgen in de ondersteuningslevenscyclus voor Azure OpenAI-API's.
Opmerking
Nieuwe API-antwoordobjecten kunnen op elk gewenst moment worden toegevoegd aan het API-antwoord. U wordt aangeraden alleen de gewenste antwoordobjecten te parseren.
API-evolutie
Voorheen ontving Azure OpenAI maandelijkse updates van nieuwe API-versies. Om nieuwe functies te benutten, was het noodzakelijk om voortdurend code- en omgevingsvariabelen bij te werken met elke nieuwe API-release. Azure OpenAI vereist ook de extra stap van het gebruik van Azure-specifieke clients, wat zorgde voor overhead bij het migreren van code tussen OpenAI en Azure OpenAI.
Vanaf augustus 2025 kunt u zich nu aanmelden voor onze volgende generatie v1 Azure OpenAI-API's die ondersteuning bieden voor:
- Doorlopende toegang tot de nieuwste functies zonder dat u elke maand nieuwe
api-versionfuncties hoeft op te geven. - Snellere API-releasecyclus met nieuwe functies die vaker worden gestart.
- OpenAI-clientondersteuning met minimale codewijzigingen om te wisselen tussen OpenAI en Azure OpenAI bij het gebruik van verificatie op basis van sleutels.
- OpenAI-clientondersteuning voor verificatie op basis van tokens en automatische tokenvernieuwing zonder dat u afhankelijk hoeft te zijn van een afzonderlijke Azure OpenAI-client.
- Voer chat-voltooiingsgesprekken uit met modellen van andere providers, zoals DeepSeek en Grok, die de syntaxis van de v1-chat-voltooiingen ondersteunen.
Toegang tot nieuwe API-aanroepen die nog in preview zijn, wordt beheerd door functiespecifieke preview-headers door te geven, zodat u zich kunt aanmelden bij de gewenste functies, zonder DAT u API-versies hoeft te wisselen. Sommige functies geven ook de preview-status aan via hun API-pad en vereisen geen extra header.
Examples:
-
/openai/v1/evalsis in preview en vereist het doorgeven van een"aoai-evals":"preview"header. -
/openai/v1/fine_tuning/alpha/graders/is in preview en vereist geen aangepaste header vanwege de aanwezigheid vanalphain het API-pad.
Voor de eerste v1 algemeen beschikbare API wordt alleen een subset van de deductie- en ontwerp-API-mogelijkheden ondersteund. Alle GA-functies worden ondersteund voor gebruik in productie. We voegen binnenkort snel ondersteuning toe voor meer mogelijkheden.
Codewijzigingen
v1 API
API-sleutel:
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()wordt gebruikt in plaats vanAzureOpenAI(). -
base_urlgeeft het Azure OpenAI-eindpunt door en/openai/v1wordt toegevoegd aan het eindpuntadres. -
api-versionis geen vereiste parameter meer met de V1 GA API.
API-sleutel met omgevingsvariabelen ingesteld voor OPENAI_BASE_URL en OPENAI_API_KEY:
client = OpenAI()
Microsoft Entra-id:
Belangrijk
Het automatisch vernieuwen van tokens werd eerder verwerkt via het gebruik van de AzureOpenAI() client. De v1-API verwijdert deze afhankelijkheid door ondersteuning voor automatisch vernieuwen van tokens toe te voegen aan de OpenAI() client.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)
client = OpenAI(
base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",
api_key = token_provider
)
response = client.responses.create(
model="gpt-4.1-nano",
input= "This is a test"
)
print(response.model_dump_json(indent=2))
-
base_urlgeeft het Azure OpenAI-eindpunt door en/openai/v1wordt toegevoegd aan het eindpuntadres. -
api_keyde parameter is ingesteld optoken_provider, waardoor automatisch ophalen en vernieuwen van een verificatietoken wordt ingeschakeld in plaats van een statische API-sleutel te gebruiken.
Modelondersteuning
Voor Azure OpenAI-modellen raden we u aan om de antwoorden-API te gebruiken, maar met de v1-API kunt u ook chat-voltooiingsoproepen uitvoeren met modellen van andere providers, zoals DeepSeek en Grok, die ondersteuning bieden voor de syntaxis voor voltooiing van de OpenAI v1-chat.
base_url accepteert zowel https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/ als https://YOUR-RESOURCE-NAME.services.ai.azure.com/openai/v1/ formaten.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)
client = OpenAI(
base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",
api_key=token_provider,
)
completion = client.chat.completions.create(
model="grok-3-mini", # Replace with your model deployment name.
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Tell me about the attention is all you need paper"}
]
)
#print(completion.choices[0].message)
print(completion.model_dump_json(indent=2))
v1 API-ondersteuning
Toestand
Algemeen beschikbare functies worden ondersteund voor gebruik in productie.
| API-pad | Toestand |
|---|---|
/openai/v1/chat/completions |
Algemeen beschikbaar |
/openai/v1/embeddings |
Algemeen beschikbaar |
/openai/v1/evals |
Preview |
/openai/v1/files |
Algemeen beschikbaar |
/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/ |
Algemeen beschikbaar |
/openai/v1/models |
Algemeen beschikbaar |
/openai/v1/responses |
Algemeen beschikbaar |
/openai/v1/vector_stores |
Algemeen beschikbaar |
Preview-headers
| API-pad | 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" |
Wijzigingen tussen versie v1 preview en 2025-04-01-preview
- v1 preview-API
- Ondersteuning voor het genereren van video's
-
NIEUW Api-functies voor antwoorden:
- Integratie van hulpprogramma's voor REMOTE Model Context Protocol (MCP)-servers
- Ondersteuning voor asynchrone achtergrondtaken
- Versleutelde redeneeropgaven
- Afbeeldingsgeneratie
Wijzigingen tussen 2025-04-01-preview en 2025-03-01-preview
Wijzigingen tussen 2025-03-01-preview en 2025-02-01-preview
Wijzigingen tussen 2025-02-01-preview en 2025-01-01-preview
- API-ondersteuning voor opgeslagen voltooiingen (distillatie).
Wijzigingen tussen 2025-01-01-preview en 2024-12-01-preview
-
predictionparameter toegevoegd voor ondersteuning voor voorspelde uitvoer. -
gpt-4o-audio-previewmodelondersteuning.
Wijzigingen tussen 2024-12-01-preview en 2024-10-01-preview
-
storeenmetadataparameters toegevoegd voor opgeslagen voltooiingen ondersteunen. -
reasoning_efforttoegevoegd voor de nieuwste redeneringsmodellen. -
user_security_contexttoegevoegd voor Microsoft Defender voor Cloud-integratie.
Wijzigingen tussen 2024-09-01-preview en 2024-08-01-preview
-
max_completion_tokenstoegevoegd aan ondersteuningo1-previeweno1-minimodellen.max_tokenswerkt niet met de o1-seriemodellen . -
parallel_tool_callstoegevoegd. -
completion_tokens_details&reasoning_tokenstoegevoegd. -
stream_options&include_usagetoegevoegd.
Wijzigingen tussen 2024-07-01-preview en 2024-08-01-preview API-specificatie
- Ondersteuning voor gestructureerde uitvoer.
- Api voor het uploaden van grote bestanden is toegevoegd.
- Wijzigingen in uw gegevens:
- Mongo DB-integratie.
-
role_informationparameter verwijderd. -
rerank_scoretoegevoegd aan bronvermeldingsobject. - AML-gegevensbron is verwijderd.
- Verbeteringen in de integratie van AI Search-vectorisatie.
Wijzigingen tussen 2024-5-01-preview en 2024-07-01-preview API-specificatie
- Ondersteuning voor Batch-API toegevoegd
- Segmenteringsstrategieparameters voor vectorarchieven
-
max_num_resultsdat het hulpprogramma voor het zoeken van bestanden moet uitvoeren.
Wijzigingen tussen 2024-04-01-preview en 2024-05-01-preview API-specificatie
- Ondersteuning voor assistenten v2 - hulpprogramma voor bestandszoekopdrachten en vectoropslag
- Controlepunten, seed, gebeurtenissen verfijnen
- Op uw gegevensupdates
- DALL-E 2 ondersteunt nu modelimplementatie en kan worden gebruikt met de nieuwste preview-API.
- Updates voor inhoudsfilters
Wijzigingen tussen 2024-03-01-preview en 2024-04-01-preview API-specificatie
-
Wijziging die fouten veroorzaken: Verbeteringen zijn verwijderd. Dit is van invloed op de
gpt-4versie:vision-previewhet model. - timestamp_granularities parameter toegevoegd.
-
audioWordobject toegevoegd. - Aanvullende TTS
response_formats: wav & pcm.
Nieuwste GA API-release
Azure OpenAI API-versie 2024-10-21 is momenteel de nieuwste GA API-release. Deze API-versie is de vervanging voor de vorige 2024-06-01 GA API-release.
Bekende problemen
- De
2025-04-01-previewAzure OpenAI-specificatie maakt gebruik van OpenAPI 3.1, is een bekend probleem dat dit momenteel niet volledig wordt ondersteund door Azure API Management