이 문서는 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를 릴리스하면 다음과 같은 두 가지 값을 latest
preview
지원합니다. 전달되지 않은 경우 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 사이의 변경 내용
- 저장된 완성(증류) API 지원.
2025-01-01-preview와 2024-12-01-preview 간의 변경 내용
- 예측 출력
prediction
지원을 위해 매개 변수를 추가했습니다. gpt-4o-audio-preview
모델 지원.
2024-12-01-미리 보기와 2024-10-01-미리 보기 간의 변경 내용
store
을 위해metadata
, 및 을(를) 추가했습니다.- 최신
reasoning_effort
을 위해 을(를) 추가했습니다. user_security_context
을 위해 을(를) 추가했습니다.
2024-09-01-미리 보기와 2024-08-01-미리 보기 간의 변경 내용
max_completion_tokens
및o1-preview
모델을 지원하기 위해o1-mini
을(를) 추가했습니다.max_tokens
은(는) o1 시리즈 모델과 작동하지 않습니다.parallel_tool_calls
이(가) 추가되었습니다.completion_tokens_details
및reasoning_tokens
을(를) 추가했습니다.stream_options
및include_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 사양 간의 변경 내용
- Batch API 지원 추가
- 벡터 저장소 청크 전략 매개 변수
max_num_results
이(가) 파일 검색 도구에서 출력되어야 합니다.
2024-04-01-preview와 2024-05-01-preview API 사양 간의 변경 내용
- 도우미 v2 지원 - 파일 검색 도구 및 벡터 스토리지
- 검사점, 시드, 이벤트 미세 조정
- 데이터 업데이트 시
- DALL-E 2는 이제 모델 배포를 지원하며 최신 미리 보기 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에서 작동하도록 하드코딩되어 있습니다.