Поделиться через

Жизненный цикл API Моделей Azure OpenAI в Azure AI Foundry Models

Эта статья поможет вам понять жизненный цикл поддержки api Azure OpenAI.

Замечание

Новые объекты ответа API могут быть добавлены в ответ API без изменений версии. Рекомендуется анализировать только необходимые объекты ответа.

Спецификация 2025-04-01-preview Azure OpenAI использует OpenAPI 3.1, является известной проблемой, которая в настоящее время не полностью поддерживается управлением API Azure.

Эволюция API

Исторически Azure OpenAI получил ежемесячные обновления новых версий API. Использование новых функций требует постоянного обновления кода и переменных среды с каждым новым выпуском API. Azure OpenAI также требует дополнительного шага использования конкретных клиентов Azure, создающих затраты при переносе кода между OpenAI и Azure OpenAI. Начиная с мая 2025 г. вы можете принять участие в следующем поколении API Azure OpenAI версии 1, которые добавляют поддержку:

  • Постоянный доступ к новейшим функциям без необходимости обновлять api-version каждый месяц.
  • Поддержка клиента OpenAI с минимальными изменениями кода для переключения между OpenAI и Azure OpenAI при использовании проверки подлинности на основе ключей.

Для начального запуска предварительной версии мы поддерживаем только подмножество API вывода. Хотя в предварительной версии операции могут иметь неполные функциональные возможности, которые будут постоянно расширяться.

Изменения в коде

API последнего поколения

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

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() клиент используется вместо AzureOpenAI().
  • base_url передает конечную точку Azure OpenAI и /openai/v1 добавляется к адресу конечной точки.
  • default_query={"api-version": "preview"} указывает, что используется API предварительного просмотра без версии up-to.

После выпуска общедоступной версии API следующего поколения v1, мы будем поддерживать два значения: latest и preview. Если api-version не передан, трафик автоматически перенаправляется в версию latest GA. Сейчас поддерживается только preview сейчас.

Предварительные версии API

Последние выпуски API OpenAI Для Azure:

Изменения между предварительной версией версии 1 и 2025-04-01-preview

  • API предварительной версии 1
  • Поддержка создания видео
  • НОВЫЕ ФУНКЦИИ Функции API ответов:
    • Интеграция инструментов с серверами протокола контекста удаленной модели (MCP)
    • Поддержка асинхронных фоновых задач
    • Зашифрованные элементы рассуждений
    • Генерирование изображений

Изменения между 2025-04-01-preview и 2025-03-01-preview

Изменения между 2025-03-01-preview и 2025-02-01-preview

Изменения между 2025-02-01-preview и 2025-01-01-preview

Изменения между 2025-01-01-preview и 2024-12-01-preview

Изменения между 2024-12-01-preview и 2024-10-01-preview

  • storeи metadata параметры, добавленные для поддержки хранимых завершений.
  • reasoning_effort добавлена последняя модель причин.
  • user_security_contextдобавлена для интеграции Microsoft Defender для облака.

Изменения между 2024-09-01-preview и 2024-08-01-preview

  • max_completion_tokens добавлена поддержка o1-preview и o1-mini модели. max_tokens не работает с моделями серии o1.
  • Добавлено: parallel_tool_calls.
  • completion_tokens_details и reasoning_tokens добавлено.
  • stream_options и include_usage добавлено.

Изменения между спецификацией API 2024-07-01-preview и 2024-08-01-preview API

  • Поддержка структурированных выходных данных.
  • Добавлен API отправки больших файлов.
  • Изменения данных:
    • Интеграция с Mongo DB.
    • role_information удален параметр.
    • rerank_score добавлен в объект ссылок.
    • Удален источник данных AML.
    • Улучшения интеграции векторизации поиска ИИ.

Изменения между спецификацией API 2024-5-01-preview и 2024-07-01-preview API

Изменения между спецификацией API 2024-04-01-preview и 2024-05-01-preview API

Изменения между спецификацией API 2024-03-01-preview и 2024-04-01-preview API

  • Критическое изменение: удалены параметры улучшения. Это влияет на версию gpt-4:vision-preview модель.
  • добавлен параметр timestamp_granularities.
  • audioWord добавлен объект.
  • Дополнительные TTS response_formats: wav & pcm.

Последний выпуск API общедоступной версии

Azure OpenAI API версии 2024-10-21 в настоящее время является последним выпуском API общедоступной версии. Эта версия API является заменой предыдущего 2024-06-01 выпуска ОБЩЕДОСТУПНОго API.

Обновление версий API

Мы рекомендуем сначала протестировать обновление до новых версий API, чтобы убедиться, что приложение не влияет на обновление API, прежде чем вносить изменения во всем мире в вашей среде.

Если вы используете клиентские библиотеки OpenAI Python или JavaScript или REST API, вам потребуется обновить код непосредственно до последней предварительной версии API.

Если вы используете один из пакетов SDK Для Azure OpenAI для C#, Go или Java, вместо этого необходимо обновить до последней версии пакета SDK. Каждый выпуск пакета SDK жестко закодирован для работы с определенными версиями API Azure OpenAI.

Дальнейшие шаги