미로
OpenAI Python SDK, 이미지 요청에 안전 식별자 지원
이미지 생성과 편집에 식별자를 전달합니다
OpenAI Python SDK 3.33.0은 한국시간 2026년 10월 17일 공개됐습니다. 이미지 생성·편집 요청에 safety_identifier를 전달하고, 응답과 스트리밍 완료 이벤트에서 실제 적용된 식별자를 확인할 수 있도록 지원합니다. 이미지를 식별하는 파일 이름이나 결과의 안전성을 보증하는 인증 값과는 다릅니다.
공식 설명은 조직의 최종 사용자를 안정적으로 구분해 안전 모니터링과 악용 탐지에 사용하는 값이라고 정의합니다. 따라서 매 요청마다 무작위로 바뀌는 작업 번호와 같은 용도로만 생각하면 원래 목적과 달라집니다.
기존 user 매개변수와 우선순위가 있습니다
PR #4093은 폐기 예정인 user 매개변수를 호환성을 위해 계속 받는다고 설명합니다. 구현 문서에 따르면 비어 있지 않은 safety_identifier가 우선하며, 생략·null·빈 문자열이면 사용 가능한 user 값을 사용합니다.
그래서 새 필드를 추가했다고 기존 값이 모든 경우에 무시된다고 가정하면 안 됩니다. 여러 호출 경로에서 한쪽은 새 값을 보내고 다른 쪽은 빈 문자열을 보내는 경우 적용 결과가 달라질 수 있습니다. 요청과 응답의 실제 식별자를 함께 대조하면 이전 과정의 누락을 찾기 쉽습니다.
원문 개인정보를 넣을 필요는 없습니다
SDK 문서는 사용자명이나 이메일을 그대로 보내지 않도록 해시 사용을 권합니다. 앱에서는 동일 사용자를 안정적으로 연결하면서도 불필요한 원문 정보를 새로 전달하지 않는 식별 방식을 검토해야 합니다. 이 값을 넣었다는 사실만으로 모든 개인정보 위험이 사라지는 것은 아니므로 접근과 로그 보존 범위도 함께 생각해야 합니다.
이 글에서는 실제 사용자 식별자를 만들거나 외부 서비스에 보낸 적이 없습니다. 테스트할 때도 합성 식별자로 필드가 유지되는지 먼저 확인하면 실제 고객 정보 없이 호출 경로를 점검할 수 있습니다.
스트리밍에서는 완료 이벤트를 확인합니다
추가된 타입은 일반 이미지 응답뿐 아니라 생성·편집의 완료 이벤트에도 유효한 식별자를 노출합니다. 모든 중간 이미지 조각에 같은 필드가 있다고 확대해서 읽어서는 안 됩니다. 앱이 부분 출력만 저장하는지 완료 상태까지 처리하는지에 따라 관찰할 위치가 다릅니다.
검토용 테스트에서는 생성과 편집, 동기와 비동기, 스트리밍과 일반 응답을 나누어 보세요. 새 식별자를 보낸 경우와 생략한 경우의 결과를 비교하고 기존 user 값이 남아 있는 호출 경로도 확인할 수 있습니다. PR은 이런 조합의 집중 테스트를 보고하지만 이 글에서 이미지 요청을 실행한 것은 아닙니다.
이번 변경은 식별자를 전달하고 확인하는 SDK 계약의 확장입니다. 특정 이미지가 안전하다거나 신고·검토가 자동으로 완료됐다는 의미로 사용하지 않는 것이 핵심입니다.
댓글
이 글에 대한 생각을 남겨 주세요.