OpenAI Python SDK, 호주·인도·일본 데이터 레지던시 옵션 추가

지역 엔드포인트를 선택하는 값이 늘었습니다

OpenAI Python SDK 3.46.0은 한국시간 2026년 11월 5일 공개됐습니다. data_residency 클라이언트 옵션에 호주 au, 인도 in, 일본 jp를 추가합니다. 클라이언트를 만들거나 복사할 때 선택할 수 있는 지역 엔드포인트 범위가 넓어진 변경입니다.

공식 코드에서는 각각 au.api.openai.com, in.api.openai.com, jp.api.openai.com의 v1 경로로 연결합니다. 단순히 표시용 지역 이름을 추가한 것이 아니라 SDK가 사용할 API 기본 주소를 결정하는 옵션입니다.

다른 경로 설정과 동시에 쓰지 않습니다

해당 버전의 resolve_data_residency 구현은 data_residency와 base_url, websocket_base_url, provider를 함께 지정하는 구성을 거부합니다. 지역 선택과 임의의 목적지 설정을 동시에 섞어 어느 주소가 사용되는지 모호하게 만드는 것을 피하는 계약입니다.

기존 서비스가 다른 제공자 어댑터나 별도의 기본 주소를 쓰고 있다면 옵션 하나만 추가하기 전에 현재 구성을 확인해야 합니다. 설정 오류를 임의로 무시하고 다른 주소로 보내는 방식이 아니라, 앱이 의도한 목적지를 명확히 선택해야 합니다.

SDK 지원과 프로젝트의 사용 자격은 다릅니다

라이브러리가 지역 값을 받아들인다는 사실만으로 모든 계정과 모델이 그 지역에서 사용할 수 있거나 모든 데이터가 동일한 방식으로 처리된다고 결론 내릴 수는 없습니다. 릴리스와 PR은 클라이언트의 엔드포인트 선택을 다루며 조직의 계약이나 개별 기능의 지역 지원 전체를 보장하지 않습니다.

따라서 운영 도입에서는 실제 프로젝트에 허용된 지역과 모델·기능 범위를 별도 확인해야 합니다. 성공 응답 한 번을 데이터 보존이나 처리 위치 전체의 준수 증거로 삼지 않는 것이 중요합니다. SDK 동작과 서비스 정책을 분리해 읽어야 합니다.

확인할 것은 설정과 실제 목적지입니다

검토용 구성에서는 민감하지 않은 입력을 사용하고, 개발·운영 프로젝트의 클라이언트 생성 설정을 나란히 확인해 보세요. 명시한 지역, 기존 기본 주소, 제공자 설정 중 무엇이 남아 있는지 먼저 보면 로컬 구성 오류와 서비스의 접근 오류를 구별하기 쉽습니다.

로그를 남길 때는 인증 정보나 요청 본문을 그대로 저장하기보다 선택한 지역과 목적지, SDK 버전, 오류 분류처럼 필요한 정보만 기록하는 편이 좋습니다. 외부 도구를 함께 호출하는 앱이라면 그 도구의 데이터 흐름도 지역 옵션 하나로 통제된다고 가정해서는 안 됩니다.

PR은 Python 3.10.16의 지역 계약 테스트 59개 통과를 보고합니다. 이는 SDK의 설정 계약을 확인한 결과이며 이 글에서 실제 지역별 API를 호출하거나 조직의 데이터 처리 조건을 검증한 것은 아닙니다.

출처

• Python SDK 3.46.0 공식 릴리스
• PR #4246 · 지역 선택 추가
• v3.46.0 지역 엔드포인트 해석 코드