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.
In dit artikel leest u hoe u de v1 Azure OpenAI-API gebruikt. De v1-API vereenvoudigt de verificatie, verwijdert de noodzaak van gedate api-version parameters en ondersteunt modeloproepen tussen providers.
Opmerking
Nieuwe API-antwoordobjecten kunnen op elk gewenst moment worden toegevoegd aan het API-antwoord. U wordt aangeraden alleen de gewenste antwoordobjecten te parseren.
Voorwaarden
- Een Azure-abonnement - Maak er gratis een
- Een Foundry-resource of Azure OpenAI-resource geïmplementeerd in een ondersteunde regio
- Ten minste één modelimplementatie
- Voor verificatie met Microsoft Entra ID: de rol
Cognitive Services OpenAI Userdie aan uw profiel is toegewezen. Zie voor meer informatie Toegangsbeheer op basis vanRole voor Azure OpenAI
API-evolutie
Eerder ontving Azure OpenAI maandelijkse updates van nieuwe API-versies. Door nieuwe functies te gebruiken, vereist voortdurend bijwerken van code en omgevingsvariabelen met elke nieuwe API-release. Azure OpenAI vereist ook de extra stap voor het gebruik van Azure specifieke clients die overhead hebben gecreëerd bij het migreren van code tussen OpenAI en Azure OpenAI.
Vanaf augustus 2025 kunt u zich aanmelden voor de 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.
Voorbeelden:
- Wanneer
/openai/v1/evalseerder in preview-modus was, moest er een"aoai-evals":"preview"koptekst worden doorgegeven. /evals is niet langer in de testfase. -
/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-lancering, wordt alleen een subset van de inferentie- en auteur-API-mogelijkheden ondersteund. Alle GA-functies worden ondersteund voor gebruik in productie. Ondersteuning voor meer mogelijkheden wordt snel toegevoegd.
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))
Belangrijke verschillen met de vorige API:
-
OpenAI()wordt gebruikt in plaats vanAzureOpenAI(). -
base_urlhet Azure OpenAI-eindpunt doorgeeft en/openai/v1wordt toegevoegd aan het eindpuntadres. -
api-versionis geen vereiste parameter meer met de V1 GA API.
API-sleutel met omgevingsvariabelen:
Stel de volgende omgevingsvariabelen in voordat u de code uitvoert:
| Variabele | Waarde |
|---|---|
OPENAI_BASE_URL |
https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/ |
OPENAI_API_KEY |
Uw Azure OpenAI API-sleutel |
Maak vervolgens de client zonder parameters:
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://ai.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_urlhet Azure OpenAI-eindpunt doorgeeft 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 Responses-API te gebruiken, maar met de v1-API kunt u ook chat-voltooiingsgesprekken voeren met modellen van andere providers, zoals DeepSeek en Grok, die ondersteuning bieden voor de syntaxis van de voltooiing van de OpenAI v1-chat.
base_url accepteert zowel https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/, https://YOUR-RESOURCE-NAME.services.ai.azure.com/openai/v1/ als formaten.
Opmerking
De Antwoorden-API werkt ook met Foundry Models die rechtstreeks worden verkocht door Azure, zoals Microsoft AI-, DeepSeek- en Grok-modellen. Zie Het genereren van tekstantwoorden met Microsoft Foundry Models voor meer informatie over het gebruik van de Antwoorden-API met deze modellen.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://ai.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="MAI-DS-R1", # 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
Wijzigingslogboek van API-versie
In de volgende secties worden wijzigingen tussen API-versies samengevat.
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 redeneringsgereedschappen
- Afbeeldingen genereren
Wijzigingen tussen 2025-04-01-preview en 2025-03-01-preview
Wijzigingen tussen 2025-03-01-preview en 2025-02-01-preview
- Antwoord-API
- Computergebruik
Wijzigingen tussen 2025-02-01-preview en 2025-01-01-preview
- Opgeslagen voltooiingen (ondersteuning voor distillatie-API).
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 ter ondersteuning van opgeslagen voltooiingen. -
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 omo1-preview- eno1-mini-modellen te ondersteunen.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-05-01-preview en 2024-07-01-preview API-specificatie
- Ondersteuning voor Batch-API toegevoegd
- Segmenteringsstrategieparameters voor vectorarchieven
-
max_num_resultsdat het bestandszoekhulpmiddel zou moeten weergeven.
Wijzigingen tussen 2024-04-01-preview en 2024-05-01-preview API-specificatie
- Ondersteuning voor assistenten v2 - hulpprogramma voor bestandszoekopdrachten en vectoropslag
- Fijnafstelling checkpoints, seed, events
- 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
-
Breaking Change: Parameters voor verbeteringen zijn verwijderd. Dit heeft invloed op het
gpt-4versie:vision-previewmodel. - timestamp_granularities parameter toegevoegd.
-
audioWordobject toegevoegd. - Aanvullende TTS
response_formats: wav & pcm.
Bekende problemen
- De
2025-04-01-previewAzure OpenAI-specificatie maakt gebruik van OpenAPI 3.1. Het is een bekend probleem dat deze versie niet volledig wordt ondersteund door Azure API Management.