다음을 통해 공유


Azure AI Foundry 모델 API 수명 주기 내에서의 Azure OpenAI

이 문서는 Azure OpenAI API에 대한 지원 수명 주기를 이해하는 데 도움이 됩니다.

비고

버전 변경 없이 새 API 응답 개체를 API 응답에 추가할 수 있습니다. 필요한 응답 개체만 구문 분석하는 것이 좋습니다.

Azure OpenAI 사양은 2025-04-01-preview OpenAPI 3.1을 사용하며, 현재 Azure API Management에서 완전히 지원되지 않는 알려진 문제입니다.

API 진화

지금까지 Azure OpenAI는 새 API 버전의 월별 업데이트를 받았습니다. 새로운 기능을 활용하려면 새로운 API 릴리스마다 코드 및 환경 변수를 지속적으로 업데이트해야 했습니다. 또한 Azure OpenAI는 OpenAI와 Azure OpenAI 간에 코드를 마이그레이션할 때 오버헤드를 발생시킨 Azure 특정 클라이언트를 사용하는 추가 단계가 필요했습니다. 2025년 5월부터 다음 지원을 추가하는 차세대 v1 Azure OpenAI API를 옵트인할 수 있습니다.

  • 매월 업데이트 api-version 할 필요 없이 최신 기능에 지속적으로 액세스합니다.
  • 키 기반 인증을 사용할 때 OpenAI와 Azure OpenAI 간에 교환하기 위한 최소한의 코드 변경으로 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"} 는 버전이 없는 항상 up-to-date 미리 보기 API가 사용 중임을 나타냅니다.

GA 차세대 v1 API를 릴리스하면 다음과 같은 두 가지 값을 latestpreview지원합니다. 전달되지 않은 경우 api-version 트래픽은 자동으로 GA 버전으로 latest 라우팅됩니다. 현재 preview 만 유일하게 지원됩니다.

프리뷰 API 릴리스

Azure OpenAI API 최신 릴리스:

v1 미리 보기 릴리스와 2025-04-01-preview 간의 변경 내용

  • v1 미리 보기 API
  • 비디오 생성 지원
  • 새로운 응답 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-미리 보기와 2024-10-01-미리 보기 간의 변경 내용

  • store을 위해 metadata, 및 을(를) 추가했습니다.
  • 최신 reasoning_effort을 위해 을(를) 추가했습니다.
  • user_security_context을 위해 을(를) 추가했습니다.

2024-09-01-미리 보기와 2024-08-01-미리 보기 간의 변경 내용

  • max_completion_tokenso1-preview 모델을 지원하기 위해 o1-mini을(를) 추가했습니다. max_tokens은(는) o1 시리즈 모델과 작동하지 않습니다.
  • parallel_tool_calls이(가) 추가되었습니다.
  • completion_tokens_detailsreasoning_tokens을(를) 추가했습니다.
  • stream_optionsinclude_usage을(를) 추가했습니다.

2024-07-01-preview와 2024-08-01-preview API 사양 간의 변경 내용

  • 구조적 출력 지원
  • 대용량 파일 업로드 API가 추가되었습니다.
  • 데이터 변경 내용:
    • Mongo DB 통합
    • role_information 매개 변수가 제거되었습니다.
    • rerank_score가 인용 개체에 추가되었습니다.
    • AML 데이터 원본이 제거되었습니다.
    • AI 검색 벡터화 통합 개선.

2024-05-01-preview와 2024-07-01-preview API 사양 간의 변경 내용

2024-04-01-preview와 2024-05-01-preview API 사양 간의 변경 내용

2024-03-01-preview와 2024-04-01-preview API 사양 간의 변경 내용

  • 호환성이 손상되는 변경: 향상된 기능 매개 변수가 제거되었습니다. 이는 gpt-4버전:vision-preview 모델에 영향을 줍니다.
  • timestamp_granularities 매개 변수가 추가되었습니다.
  • audioWord 개체가 추가되었습니다.
  • 추가 TTS response_formats: wav & pcm.

최신 GA API 릴리스

Azure OpenAI API 버전 2024-10-21은 현재 최신 GA API 릴리스입니다. 이 API 버전은 이전 2024-06-01 GA API 릴리스를 대체합니다.

API 버전 업데이트

먼저 새 API 버전으로 업그레이드를 테스트하여 환경 전체에서 변경하기 전에 API 업데이트에서 애플리케이션에 영향을 주지 않는지 확인하는 것이 좋습니다.

OpenAI Python 또는 JavaScript 클라이언트 라이브러리 또는 REST API를 사용하는 경우 코드를 최신 미리 보기 API 버전으로 직접 업데이트해야 합니다.

C#, Go 또는 Java용 Azure OpenAI SDK 중 하나를 사용하는 경우 대신 최신 버전의 SDK로 업데이트해야 합니다. 각 SDK 릴리스는 특정 버전의 Azure OpenAI API에서 작동하도록 하드코딩되어 있습니다.

다음 단계