Dela via


Livscykel för Azure OpenAI i Azure AI Foundry Models API

Den här artikeln hjälper dig att förstå supportlivscykeln för Azure OpenAI-API:er.

Anmärkning

Nya API-svarsobjekt kan när som helst läggas till i API-svaret. Vi rekommenderar att du bara parsar de svarsobjekt som du behöver.

API-utveckling

Tidigare mottog Azure OpenAI månatliga uppdateringar av nya API-versioner. Dra nytta av nya funktioner som krävs för att ständigt uppdatera kod- och miljövariabler med varje ny API-version. Azure OpenAI krävde också det extra steget för att använda Azure-specifika klienter som skapade omkostnader vid migrering av kod mellan OpenAI och Azure OpenAI.

Från och med augusti 2025 kan du nu välja våra nästa generation v1 Azure OpenAI API:er som lägger till stöd för:

  • Löpande åtkomst till de senaste funktionerna utan att behöva ange nya api-versionvarje månad.
  • Snabbare API-versionscykel med nya funktioner som startas oftare.
  • OpenAI-klientstöd med minimala kodändringar för växling mellan OpenAI och Azure OpenAI när du använder nyckelbaserad autentisering.
  • OpenAI-klientstöd för tokenbaserad autentisering och automatisk tokenuppdatering utan att behöva använda ett beroende av en separat Azure OpenAI-klient.
  • Gör samtal om chattavslut med modeller från andra leverantörer som DeepSeek och Grok som stöder syntaxen för slutförande av v1-chattar.

Åtkomst till nya API-anrop som fortfarande är i förhandsversion styrs genom att funktionsspecifika förhandsgranskningshuvuden skickas så att du kan välja de funktioner du vill använda, utan att behöva byta API-versioner. Alternativt kan vissa funktioner ange förhandsversionsstatus via sin API-sökväg och kräver inte en ytterligare header.

Examples:

  • /openai/v1/evals är i förhandsversion och kräver att ett "aoai-evals":"preview" sidhuvud skickas.
  • /openai/v1/fine_tuning/alpha/graders/ är i förhandsversion och kräver inget anpassat huvud på grund av förekomsten av alpha i API-sökvägen.

För den första v1 Allmänt tillgängliga API-starten stöder vi bara en delmängd av funktionerna för slutsatsdragning och redigering av API. Alla GA-funktioner stöds för användning i produktion. Vi kommer snabbt att lägga till stöd för fler funktioner snart.

Kodändringar

v1 API

Python v1-exempel

API-nyckel:

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() -klienten används i stället för AzureOpenAI().
  • base_url passerar Azure OpenAI-slutpunkten och /openai/v1 läggs till slutpunktsadressen.
  • api-version är inte längre en obligatorisk parameter med v1 GA-API:et.

API-nyckel med miljövariabler inställda för OPENAI_BASE_URL och OPENAI_API_KEY:

client = OpenAI()

Microsoft Entra-ID:

Viktigt!

Hantering av automatisk tokenuppdatering hanterades tidigare med hjälp av AzureOpenAI() klienten. V1-API:et tar bort det här beroendet genom att lägga till stöd för automatisk tokenuppdatering till OpenAI() klienten.

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 passerar Azure OpenAI-slutpunkten och /openai/v1 läggs till slutpunktsadressen.
  • api_key parametern är inställd på token_provider, vilket aktiverar automatisk hämtning och uppdatering av en autentiseringstoken i stället för att använda en statisk API-nyckel.

Modellstöd

För Azure OpenAI-modeller rekommenderar vi att du använder Svars-API:et, men med v1-API:et kan du också göra samtal om chattavslut med modeller från andra leverantörer som DeepSeek och Grok som stöder syntaxen för att slutföra OpenAI v1-chattar.

base_url accepterar både https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/ och https://YOUR-RESOURCE-NAME.services.ai.azure.com/openai/v1/ format.

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))

stöd för v1 API

Läge

Allmänt tillgängliga funktioner stöds för användning i produktion.

API-sökväg Läge
/openai/v1/chat/completions Allmänt tillgängligt
/openai/v1/embeddings Allmänt tillgängligt
/openai/v1/evals Preview
/openai/v1/files Allmänt tillgängligt
/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/ Allmänt tillgängligt
/openai/v1/models Allmänt tillgängligt
/openai/v1/responses Allmänt tillgängligt
/openai/v1/vector_stores Allmänt tillgängligt

Förhandsgranskningsrubriker

API-sökväg 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"

Ändringar mellan förhandsversionen av v1 och förhandsversionen 2025-04-01

Ändringar mellan 2025-04-01-preview och 2025-03-01-preview

Ändringar mellan 2025-03-01-preview och 2025-02-01-preview

Ändringar mellan 2025-02-01-preview och 2025-01-01-preview

Ändringar mellan 2025-01-01-preview och 2024-12-01-preview

Ändringar mellan 2024-12-01-preview och 2024-10-01-preview

Ändringar mellan 2024-09-01-preview och 2024-08-01-preview

  • max_completion_tokens har lagts till i stöd o1-preview och o1-mini modeller. max_tokens fungerar inte med modellerna i o1-serien .
  • parallel_tool_calls har lagts till.
  • completion_tokens_details & reasoning_tokens tillagt.
  • stream_options & include_usage tillagt.

Ändringar mellan API-specifikationen 2024-07-01-preview och 2024-08-01-preview

  • Stöd för strukturerade utdata.
  • API för stor filuppladdning har lagts till.
  • Om dina data ändras:
    • Mongo DB-integrering.
    • role_information parametern har tagits bort.
    • rerank_score har lagts till i källhänvisningsobjektet.
    • AML-datakällan har tagits bort.
    • Förbättringar av integrering av AI Search-vektorisering.

Ändringar mellan API-specifikationen 2024-5-01-preview och 2024-07-01-preview

Ändringar mellan API-specifikationen 2024-04-01-preview och 2024-05-01-preview

Ändringar mellan API-specifikationen 2024-03-01-preview och 2024-04-01-preview

  • Icke-bakåtkompatibel ändring: Förbättringar har tagits bort. Detta påverkar gpt-4modellen Version:vision-preview .
  • timestamp_granularities parametern har lagts till.
  • audioWord objektet har lagts till.
  • Ytterligare TTS response_formats: wav & pcm.

Senaste GA API-versionen

Azure OpenAI API version 2024-10-21 är för närvarande den senaste GA API-versionen. Den här API-versionen ersätter den tidigare 2024-06-01 GA API-versionen.

Kända problemområden

  • 2025-04-01-preview Azure OpenAI-specifikationen använder OpenAPI 3.1, är ett känt problem som för närvarande inte stöds fullt ut av Azure API Management

Nästa steg