Delen via


Azure OpenAI in de API-levenscyclus van Azure AI Foundry Models

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

Voorbeelden van Python v1

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 van AzureOpenAI().
  • base_url geeft het Azure OpenAI-eindpunt door en /openai/v1 wordt toegevoegd aan het eindpuntadres.
  • api-version is 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_url geeft het Azure OpenAI-eindpunt door 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 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

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

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 aan ondersteuning o1-preview en o1-mini modellen. 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-5-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

  • Wijziging die fouten veroorzaken: Verbeteringen zijn verwijderd. Dit is van invloed op de gpt-4versie:vision-preview het model.
  • timestamp_granularities parameter toegevoegd.
  • audioWord object 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-preview Azure OpenAI-specificatie maakt gebruik van OpenAPI 3.1, is een bekend probleem dat dit momenteel niet volledig wordt ondersteund door Azure API Management

Volgende stappen