OpenAI API 이미지 여러 장을 요청했는데 한 장만 저장되면 어떻게 하나요? 초보자 결과 개수 확인법

질문

OpenAI API 이미지 여러 장을 요청했는데 한 장만 저장되면 어떻게 하나요?

답변

이미지 생성 요청에 여러 장을 뜻하는 n 값을 넣었는지와 완료된 응답의 data 에 이미지가 몇 개 있는지부터 확인하세요. 공식 예제는 첫 번째 이미지인 data[0] 만 파일로 저장합니다. 여러 장을 받았더라도 그 줄만 실행하면 로컬에는 한 장만 남습니다.

이 글은 Image API에서 요청 수·반환 수·저장 수를 구분하는 방법입니다. 이전 글의 Base64 디코딩과 파일 형식 설명을 반복하기보다, 결과 배열 전체를 검사하고 각 이미지를 다른 이름으로 저장하는 데 집중합니다.

모델의 n 지원 확인 → 실제 n 요청 → data 항목 수 확인 → 항목별 다른 파일명으로 저장 → 파일을 직접 열어 대조 순서로 진행하세요. 요청한 수와 받은 수, 디스크에 남긴 수는 서로 다른 숫자입니다.

OpenAI의 이미지 생성 가이드는 Image API에서 n을 지정하면 한 요청으로 여러 이미지를 생성할 수 있으며 기본 응답은 한 장이라고 안내합니다. 다만 생성 모델별로 허용 범위가 다릅니다. Create image 문서는 n의 범위를 1부터 10까지로 안내합니다. 사용하려는 GPT Image 모델의 조건을 확인한 뒤 값을 고르세요.

공식 Image API 예제는 result.data[0].b64_json 을 읽고 파일 하나를 만듭니다. 예제는 첫 이미지 저장을 보여 주는 것이지 전체 결과를 저장하는 반복문이 아닙니다. 완료 응답의 data 길이를 먼저 확인한 뒤, 존재하는 각 항목의 이미지 데이터를 따로 저장해야 누락 여부를 알 수 있습니다.

Responses API의 이미지 생성 도구를 썼다면 확인 위치가 다릅니다. 공식 도구 가이드는 response.output 에서 image_generation_call 을 찾아 각 result 를 읽습니다. Image API의 n과 data 사용법을 이 도구의 입력·출력 구조에 그대로 적용하지 마세요.

한 줄 정리: API가 한 장만 돌려준 것인지, 코드가 첫 장만 꺼냈는지, 저장할 때 덮어쓴 것인지를 순서대로 나눠 보면 원인을 좁힐 수 있습니다.

• OpenAI API의 Base64 이미지는 어떻게 파일로 저장하나요?
• 이미지 분석 detail과 이미지 생성의 설정은 무엇이 다른가요?
• 이미지 생성 메뉴·사용 한도가 막혔을 때는 어떻게 하나요?