Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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 avalphai 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
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örAzureOpenAI(). -
base_urlpasserar Azure OpenAI-slutpunkten och/openai/v1lä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_urlpasserar Azure OpenAI-slutpunkten och/openai/v1läggs till slutpunktsadressen. -
api_keyparametern ä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
- förhandsversions-API för v1
- Stöd för videogenerering
-
NY API-svarsfunktioner:
- MCP-servrar (Remote Model Context Protocol) verktygsintegration
- Stöd för asynkrona bakgrundsaktiviteter
- Krypterade resonemangsobjekt
- Bildgenerering
Ändringar mellan 2025-04-01-preview och 2025-03-01-preview
Ändringar mellan 2025-03-01-preview och 2025-02-01-preview
- Svar-API
- Datoranvändning
Ändringar mellan 2025-02-01-preview och 2025-01-01-preview
- Lagrade slutföranden (destillation) API-stöd.
Ändringar mellan 2025-01-01-preview och 2024-12-01-preview
-
predictionparametern har lagts till för stöd för förutsagda utdata. -
gpt-4o-audio-previewmodellstöd.
Ändringar mellan 2024-12-01-preview och 2024-10-01-preview
-
storemetadataoch parametrar som har lagts till för stöd för lagrade slutföranden. -
reasoning_effortlagts till för de senaste resonemangsmodellerna. -
user_security_contexthar lagts till för Microsoft Defender för molnet integrering.
Ändringar mellan 2024-09-01-preview och 2024-08-01-preview
-
max_completion_tokenshar lagts till i stödo1-previewocho1-minimodeller.max_tokensfungerar inte med modellerna i o1-serien . -
parallel_tool_callshar lagts till. -
completion_tokens_details&reasoning_tokenstillagt. -
stream_options&include_usagetillagt.
Ä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_informationparametern har tagits bort. -
rerank_scorehar 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
- Stöd för Batch API har lagts till
- Strategiparametrar för segmentering av vektorlager
-
max_num_resultsatt filsökningsverktyget ska visa.
Ändringar mellan API-specifikationen 2024-04-01-preview och 2024-05-01-preview
- Stöd för Assistenter v2 – Filsökningsverktyg och vektorlagring
- Finjustering av kontrollpunkter, startpunkt, händelser
- På dina datauppdateringar
- DALL-E 2 stöder nu modelldistribution och kan användas med det senaste förhandsversions-API:et.
- Uppdateringar av innehållsfiltrering
Ä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.
-
audioWordobjektet 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-previewAzure 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