Sdílet prostřednictvím

Životní cyklus API modelů Azure OpenAI v Azure AI Foundry

Tento článek vám pomůže pochopit životní cyklus podpory pro rozhraní API Azure OpenAI.

Poznámka:

Nové objekty odpovědi rozhraní API se můžou přidat do odpovědi rozhraní API bez změn verze. Doporučujeme analyzovat pouze požadované objekty odpovědi.

Specifikace 2025-04-01-preview Azure OpenAI používá OpenAPI 3.1. Je známým problémem, že Azure API Management to v současné době plně nepodporuje.

Vývoj rozhraní API

V minulosti služba Azure OpenAI obdržela měsíční aktualizace nových verzí rozhraní API. Využití nových funkcí vyžadovalo neustálou aktualizaci kódu a proměnných prostředí s každou novou verzí rozhraní API. Azure OpenAI také vyžadoval další krok při používání konkrétních klientů Azure, kteří při migraci kódu mezi OpenAI a Azure OpenAI vytvořili režijní náklady. Od května 2025 se teď můžete přihlásit k naší nové generaci rozhraní API Azure OpenAI v1, která přidávají podporu pro:

  • Průběžný přístup k nejnovějším funkcím, které nemusíte každý měsíc aktualizovat api-version .
  • Podpora pro klienty OpenAI s minimálními změnami kódu pro vzájemnou výměnu mezi OpenAI a Azure OpenAI při použití ověřování založeného na klíči.

Pro počáteční spuštění verze Preview podporujeme pouze podmnožinu rozhraní API pro odvozování. V náhledu můžou mít operace neúplné funkce, které se budou průběžně rozšiřovat.

Změny kódu

Rozhraní API poslední generace

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

Rozhraní API nové generace

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() klient se používá místo AzureOpenAI().
  • base_url předá koncový bod Azure OpenAI a /openai/v1 připojí se k adrese koncového bodu.
  • default_query={"api-version": "preview"} označuje, že se používá náhledové API bez verzí up-to-datum.

Jakmile uvolníme rozhraní API nové generace v1, budeme podporovat dvě hodnoty: latest a preview. Pokud api-version není předán, provoz se automaticky směruje na verzi GA latest. V současné době se podporuje pouze preview.

Náhledové verze API

Nejnovější verze rozhraní API Azure OpenAI:

Změny mezi verzí v1 Preview a 2025-04-01-preview

Změny mezi verzemi 2025-04-01-preview a 2025-03-01-preview

Změny mezi 2025-03-01-preview a 2025-02-01-preview

Změny mezi 2025-02-01-preview a 2025-01-01-preview

Změny mezi 1. 1. 2025 a 12. 12. 2024

Změny mezi 12. 12. 2024 a 10. 10. 2024 ve verzi Preview

  • storea metadata parametry přidané pro podporu uložených dokončení.
  • reasoning_effort přidáno z nejnovějších modelů odůvodnění.
  • user_security_context přidáno pro integraci Microsoft Defenderu pro cloud.

Změny mezi 9. 9. 2024 a 2024-08-01-preview

  • max_completion_tokens přidáno do podpory o1-preview a o1-mini modelů. max_tokens nefunguje s modely řady o1.
  • Přidáno: parallel_tool_calls.
  • completion_tokens_details & reasoning_tokens přidáno.
  • stream_options & include_usage přidáno.

Změny mezi specifikací rozhraní API verze 2024-07-07-01-Preview a 2024-08-01-Preview

  • Podpora strukturovaných výstupů
  • Bylo přidáno rozhraní API pro nahrávání velkých souborů.
  • Změny dat:
    • Integrace Mongo DB.
    • role_information parametr byl odebrán.
    • rerank_score přidáno do objektu citace.
    • Zdroj dat AML byl odebrán.
    • Vylepšení integrace vektorizace vyhledávání AI

Změny mezi specifikací rozhraní API verze 2024-5-01-preview a 2024-07-01-preview

Změny mezi specifikací rozhraní API verze 2024-04-01-preview a 2024-05-01-preview

Změny mezi specifikací rozhraní API verze 2024-03-01-preview a 2024-04-01-preview

  • Změna způsobující chybu: Parametry vylepšení byly odebrány. To má vliv na gpt-4model Version: (Verze:vision-preview model).
  • timestamp_granularities přidaný parametr.
  • audioWord objekt přidán.
  • Další TTS response_formats: wav & pcm.

Nejnovější verze rozhraní GA API

Rozhraní API Azure OpenAI verze 2024-10-21 je aktuálně nejnovější verzí rozhraní GA API. Tato verze rozhraní API je náhradou za předchozí 2024-06-01 verzi rozhraní GA API.

Aktualizace verzí rozhraní API

Doporučujeme nejprve otestovat upgrade na nové verze rozhraní API, abyste před globální změnou ve vašem prostředí ověřili, že vaše aplikace nemá žádný vliv na aktualizaci rozhraní API.

Pokud používáte klientské knihovny OpenAI Python nebo JavaScript nebo rozhraní REST API, budete muset kód aktualizovat přímo na nejnovější verzi rozhraní API ve verzi Preview.

Pokud používáte některou ze sad SDK Azure OpenAI pro C#, Go nebo Java, budete místo toho muset aktualizovat na nejnovější verzi sady SDK. Každá verze sady SDK je pevně zakódovaná tak, aby fungovala s konkrétními verzemi rozhraní API Azure OpenAI.

Další kroky