AI 초보자 QnA
질문
OpenAI API에서 사진의 일부만 바꾸려면 마스크를 어떻게 쓰나요?
답변
기존 사진에서 한 부분만 바꾸고 싶다면 Image API의 images.edit에 원본 이미지와 마스크, 수정 내용을 적은 prompt를 함께 보냅니다. 마스크에서 완전히 투명한 부분이 편집을 요청할 영역입니다. 검은색으로 칠하기만 한 그림과는 다릅니다.
마스크는 위치를 알려 주는 안내입니다. 모델이 경계를 픽셀 단위로 정확히 지킨다는 보장은 없으므로, 편집 뒤 원본과 결과를 나란히 비교하세요. 이 글은 ChatGPT 화면에서 선택 영역을 칠하는 방법이 아니라 OpenAI API 파일 입력 설정을 다룹니다.
짧게 답하면
원본 준비 → 같은 치수의 알파 채널 마스크 만들기 → 투명하게 바꿀 영역 표시 → images.edit 요청 → 바깥 영역 비교 순서입니다. 마스크가 없는 일반 편집 요청과 달리 API에 별도 mask 파일을 전달합니다.
원본 image
지금 가진 사진입니다. 파일을 바꿀 권리와 공개 가능 범위를 먼저 확인합니다.
편집 mask
완전히 투명한 부분이 수정할 영역입니다. 원본과 가로·세로 픽셀을 맞춥니다.
수정 prompt
바꿀 부분과 유지할 피사체를 글로 적습니다. 마스크의 경계만 믿지 않습니다.
처음 쓰는 사람 기준으로 설명하면
한 줄 정리: 마스크는 바꿀 곳을 안내하는 파일이고, 보존할 곳이 정확히 유지됐는지는 결과 사진을 본 사람이 확인합니다.
Image generation 가이드는 마스크가 모델의 편집을 안내하지만 정확한 윤곽을 보장하지 않는다고 명시합니다. 여러 입력 사진을 보내면 마스크는 첫 사진에 적용됩니다. 제품 글자나 사람 얼굴처럼 그대로여야 할 부분이 있다면 prompt에도 보존 조건을 적고, 생성 후에는 확대해 원본과 대조합니다.
Image prompting 문서도 이미지 편집에
client.images.edit
를 사용하고 국소 편집에는 마스크 안내를 보라고 합니다. 첫 시험은 한 장의 원본으로 시작하세요. Image API의
mask
와 Responses API 이미지 생성 도구의
input_image_mask
는 서로 다른 요청 필드이므로 복사해서 섞지 마세요.
한 줄 정리: 출력 픽셀 크기를 정하려면 그림 설명에만 적지 말고, 선택한 모델의 지원 범위에 맞춰 size를 API 요청에 넣으세요.
바로 따라 해보기
1단계. 원본과 수정 범위를 정합니다.
권한이 있는 사진의 복사본을 만들고, 바꿀 부분을 한 곳만 고릅니다. 그대로 둘 글자·사람·물체를 따로 적어 두세요. 처음에는 민감한 자료나 판매 중인 제품의 필수 표기를 넣지 않습니다.
2단계. 마스크를 준비해 요청합니다.
원본과 가로·세로가 같은 PNG 마스크를 만들고 수정할 곳을 완전히 투명하게 저장합니다. 공식 Edit image 문서의 파일 조건을 확인한 뒤
client.images.edit
에서
model
,
image
,
mask
,
prompt
를 구분해 전달합니다. 요청 전 마스크 파일에 알파 채널이 있는지 확인하세요.
3단계. 결과와 원본을 대조합니다.
예를 들어 “벽의 얼룩만 없애고 액자와 글자는 유지해 주세요”처럼 쓰고 받은 이미지를 저장합니다. 투명 영역 밖의 경계·글자·얼굴이 달라졌다면 그대로 사용하지 말고 마스크나 지시를 고쳐 작은 범위에서 다시 시험하세요.
주의할 점
마스크가 투명한 곳만 바꾼다고 지시해도 결과의 다른 부분이 달라질 수 있습니다.
background="transparent"
는 생성된 이미지의 배경 설정이며 편집용
mask
와 역할이 다릅니다. 원본은 덮어쓰지 말고 필요하면 결과를 사람에게 다시 보여 주세요.
마스크가 원본과 크기가 다르거나 알파 채널이 없습니다. 화면에서 흰색처럼 보여도 실제 투명한 픽셀인지 파일을 검사하세요.
여러 사진을 입력하면서 마스크가 두 번째 사진에 적용된다고 가정합니다. 공식 가이드는 첫 입력 사진에 적용된다고 설명합니다.
선택 밖의 가격표·로고·얼굴이 변해도 마스크가 있으니 안전하다고 생각합니다. 중요한 요소는 원본과 직접 대조하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
파일 조건과 요청법은 공식 웹 문서에서
Image generation 가이드에서 마스크의 역할과 한계를 읽고, Edit image API 문서에서 필드와 파일 조건을 확인하세요. ChatGPT 웹의 편집 메뉴를 Image API의 mask 필드와 혼동하지 않습니다.
마스크 작성과 결과 검사는 편집 앱에서
알파 채널을 저장할 수 있는 이미지 편집 앱에서 원본과 같은 크기의 마스크를 만든 뒤 개발 환경에서 작은 요청을 보내세요. 결과는 원본과 나란히 열어 변경 범위를 확인합니다.
같이 보면 좋은 질문
확인한 공식 자료
OpenAI 공식 가이드 — Image generation — 마스크가 편집 위치를 안내하되 정확한 경계를 보장하지 않고, 여러 입력 시 첫 사진에 적용되는 조건을 확인했습니다.
OpenAI API 문서 — Create image edit — 이미지 편집 요청의 image·mask·prompt 필드와 투명 영역·파일 형식 조건을 확인했습니다.
OpenAI 공식 가이드 — Image prompting — client.images.edit 사용과 국소 편집을 위한 마스크 안내, 보존할 요소를 글로 지정하는 예시를 확인했습니다.
감자나라 AI 강의보기 5,000 
