OpenAI Python SDK, HTTPX2 마이그레이션 및 TLS 인증 방식 변경

OpenAI Python SDK의 동기 및 비동기 HTTP 클라이언트가 HTTPX2로 마이그레이션되었다. openai 패키지 설치 시 HTTPX2가 자동으로 설치되며, 기존 httpx 패키지는 더 이상 설치되지 않는다.

TLS 인증 및 신뢰 저장소 변경

HTTPX2는 기본 TLS 신뢰 저장소로 운영체제(OS)의 신뢰 저장소를 사용하며, 기존에 사용되던 certifi CA 번들 의존성이 제거되었다. 이로 인해 시스템 CA 인증서가 없는 최소화된 컨테이너 이미지나 기업용 TLS 검사 프록시 환경에서 인증 오류가 발생할 수 있다. 해당 환경에서는 SSL_CERT_FILE 또는 SSL_CERT_DIR 환경 변수를 설정하거나, ssl.SSLContext를 명시적으로 전달해야 한다.

API 및 클래스 변경 사항

사용자가 커스텀 HTTP 클라이언트를 사용하는 경우, 기존 httpx 관련 객체를 httpx2 객체로 교체해야 한다.

• 클라이언트 클래스: httpx.Client → httpx2.Client, httpx.AsyncClient → httpx2.AsyncClient
• 설정 객체: httpx.Timeout, httpx.URL, httpx.Limits 등은 각각 httpx2 버전으로 대체
• 호환성: 기존 DefaultHttpxClient 및 DefaultAsyncHttpxClient 이름은 계속 지원되나, 내부적으로는 HTTPX2 클라이언트를 생성한다. 명시적인 사용을 위해 DefaultHttpx2Client 및 DefaultAsyncHttpx2Client 사용을 권장한다.

기본 HTTP 클라이언트를 사용하는 경우 API 호출, 스트리밍, 재시도, 타임아웃 설정 등은 기존과 동일하게 동작한다. 다만, SDK를 통해 httpx를 간접적으로 설치해 사용하던 코드는 직접 httpx 의존성을 추가하거나 httpx2로 마이그레이션해야 한다.