Azure OpenAI binnen Microsoft Foundry Models v1 API

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

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/evals eerder 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 van alpha in 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

Python v1-voorbeelden

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 van AzureOpenAI().
  • base_url het Azure OpenAI-eindpunt doorgeeft en /openai/v1 wordt toegevoegd aan het eindpuntadres.
  • api-version is 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_url het Azure OpenAI-eindpunt doorgeeft en /openai/v1 wordt toegevoegd aan het eindpuntadres.
  • api_key de parameter is ingesteld op token_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

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

  • Opgeslagen voltooiingen (ondersteuning voor distillatie-API).

Wijzigingen tussen 2025-01-01-preview en 2024-12-01-preview

Wijzigingen tussen 2024-12-01-preview en 2024-10-01-preview

Wijzigingen tussen 2024-09-01-preview en 2024-08-01-preview

  • max_completion_tokens toegevoegd om o1-preview- en o1-mini-modellen te ondersteunen. max_tokens werkt niet met de o1-seriemodellen .
  • parallel_tool_calls Toegevoegd.
  • completion_tokens_details & reasoning_tokens toegevoegd.
  • stream_options & include_usage toegevoegd.

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_information parameter verwijderd.
    • rerank_score toegevoegd 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

Wijzigingen tussen 2024-04-01-preview en 2024-05-01-preview API-specificatie

Wijzigingen tussen 2024-03-01-preview en 2024-04-01-preview API-specificatie

Bekende problemen

  • De 2025-04-01-preview Azure OpenAI-specificatie maakt gebruik van OpenAPI 3.1. Het is een bekend probleem dat deze versie niet volledig wordt ondersteund door Azure API Management.

Volgende stappen