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 läggas till i API-svaret utan versionsändringar. Vi rekommenderar att du bara parsar de svarsobjekt som du behöver.

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

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 maj 2025 kan du nu välja vår nästa generation av v1 Azure OpenAI-API:er som lägger till stöd för:

• Löpande åtkomst till de senaste funktionerna utan att behöva uppdatera api-version varje månad.
• OpenAI-klientstöd med minimala kodändringar för växling mellan OpenAI och Azure OpenAI när du använder nyckelbaserad autentisering.

För den första förhandsgranskningsstarten stöder vi bara en delmängd av slutsatsdragnings-API:et. I förhandsversionen kan åtgärder ha ofullständiga funktioner som kontinuerligt utökas.

Kodändringar

API-nyckel

API för senaste generationen

import os
from openai import AzureOpenAI

client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2025-04-01-preview",
    azure_endpoint="https://YOUR-RESOURCE-NAME.openai.azure.com")
    )

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

Nästa generations API

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/",
    default_query={"api-version": "preview"}, 
)

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.
• default_query={"api-version": "preview"} anger att det versionslösa api:et alltid up-to-date preview används.

När vi har släppt API:et för nästa generation v1 stöder vi två värden: latest och preview. Om api-version inte skickas dirigeras trafiken automatiskt till GA-versionen latest . För närvarande stöds endast preview.

Microsoft Entra-ID

API för senaste generationen

from openai import AzureOpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)

client = AzureOpenAI(
  azure_endpoint = "https://YOUR-RESOURCE-NAME.openai.azure.com/", 
  azure_ad_token_provider=token_provider,
  api_version="2025-04-01-preview"
)

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

Nästa generations API

from openai import AzureOpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)

client = AzureOpenAI(  
  base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",  
  azure_ad_token_provider=token_provider,
  api_version="preview"
)

response = client.responses.create(
    model="gpt-4.1-nano",
    input= "This is a test" 
)

print(response.model_dump_json(indent=2)) 

• AzureOpenAI() används för att dra nytta av automatisk tokenuppdatering som tillhandahålls av azure_ad_token_provider.
• base_url passerar Azure OpenAI-slutpunkten och /openai/v1 läggs till slutpunktsadressen.
• api-version="preview" anger att det versionslösa api:et alltid up-to-date preview används.

När vi har släppt API:et för nästa generation v1 stöder vi två värden: latest och preview. Om api-version inte skickas dirigeras trafiken automatiskt till GA-versionen latest . För närvarande stöds endast preview.

VILA

API för senaste generationen

API-nyckel:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/responses?api-version=2025-04-01-preview \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -d '{
     "model": "gpt-4.1-nano",
     "input": "This is a test"
    }'

Microsoft Entra-ID:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/responses?api-version=2025-04-01-preview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
  -d '{
     "model": "gpt-4.1-nano",
     "input": "This is a test"
    }'

Nästa generations API

API-nyckel:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/responses?api-version=preview \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -d '{
     "model": "gpt-4.1-nano",
     "input": "This is a test"
    }'

Microsoft Entra-ID:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/responses?api-version=preview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
  -d '{
     "model": "gpt-4o",
     "input": "This is a test"
    }'

Resultat

{
  "id": "resp_682f7eb5dc408190b491cbbe57be2fbf0f98d661c3dc276d",
  "created_at": 1747943093.0,
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "metadata": {},
  "model": "gpt-4.1-nano",
  "object": "response",
  "output": [
    {
      "id": "msg_682f7eb61d908190926a004c15c5ddd00f98d661c3dc276d",
      "content": [
        {
          "annotations": [],
          "text": "Hello! It looks like you've sent a test message. How can I assist you today?",
          "type": "output_text"
        }
      ],
      "role": "assistant",
      "status": "completed",
      "type": "message"
    }
  ],
  "parallel_tool_calls": true,
  "temperature": 1.0,
  "tool_choice": "auto",
  "tools": [],
  "top_p": 1.0,
  "background": null,
  "max_output_tokens": null,
  "previous_response_id": null,
  "reasoning": {
    "effort": null,
    "generate_summary": null,
    "summary": null
  },
  "service_tier": "default",
  "status": "completed",
  "text": {
    "format": {
      "type": "text"
    }
  },
  "truncation": "disabled",
  "usage": {
    "input_tokens": 12,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 19,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 31
  },
  "user": null,
  "store": true
}

Förhandsversioner av API

De senaste versionerna av Azure OpenAI API:

• NY v1 förhandsvisnings-API
• Slutsatsdragning: 2025-04-01-preview
• Författande: 2025-04-01-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

• GPT-image-1 stöd
• Resonemangssammanfattning för o3 och o4-mini
• Utvärderings-API

Ä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

• prediction parametern har lagts till för stöd för förutsagda utdata.
• gpt-4o-audio-preview modellstöd.

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

• store metadata och parametrar som har lagts till för stöd för lagrade slutföranden.
• reasoning_effort lagts 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_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

• Stöd för Batch API har lagts till
• Strategiparametrar för segmentering av vektorlager
• max_num_results att 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.
• 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.

Uppdatera API-versioner

Vi rekommenderar att du först testar uppgraderingen till nya API-versioner för att bekräfta att det inte påverkar ditt program från API-uppdateringen innan du gör ändringen globalt i din miljö.

Om du använder OpenAI Python- eller JavaScript-klientbiblioteken eller REST-API:et måste du uppdatera koden direkt till den senaste förhandsversionen av API:et.

Om du använder någon av Azure OpenAI SDK:erna för C#, Go eller Java måste du i stället uppdatera till den senaste versionen av SDK:t. Varje SDK-version är hårdkodad för att fungera med specifika versioner av Azure OpenAI API.

Nästa steg

• Läs mer om Azure OpenAI
• Lär dig mer om att arbeta med Azure OpenAI-modeller