AI 초보자 QnA
질문
OpenAI API가 그림을 만드는 동안 중간 이미지를 볼 수 있나요?
답변
네. Image API와 Responses API의 이미지 생성 도구는 스트리밍으로 중간 이미지를 보내는 방식을 지원합니다. 그림이 끝날 때까지 빈 화면만 보는 대신 진행 중인 모습을 받을 수 있습니다.
다만 중간 이미지는 완성본이 아닙니다. 최종 결과를 따로 확인하고 저장해야 하며, 요청한 중간 이미지 수가 모두 도착한다고 보장하지도 않습니다.
짧게 답하면
이미지 생성 스트림 열기 → 부분 이미지 이벤트 보기 → 완성 이벤트와 최종 파일 확인하기 순서입니다. 부분 이미지가 보였다는 사실만으로 생성이 끝났다고 판단하지 마세요.
stream
완성될 때까지 기다리는 일반 응답 대신 생성 이벤트를 순서대로 받습니다.
partial_images
중간 이미지를 몇 장 요청할지 정합니다. 실제 도착 수는 더 적을 수 있습니다.
최종 이미지
임시 미리보기와 구분해 별도 이름으로 저장하고 열어 봅니다.
처음 쓰는 사람 기준으로 설명하면
보통 이미지를 요청하면 완성된 뒤 결과를 받습니다. 스트리밍을 켜면 만드는 도중의 이미지도 순서대로 받아 화면에 보여 줄 수 있습니다. 공식 이미지 생성 가이드는 Image API와 Responses API 양쪽의 예시를 제공하며, 중간 이미지 요청 값은 0부터 3까지로 설명합니다. 0이면 최종 이미지만 받습니다.
Image API의 생성 예시는
images.generate
에
stream=True
와
partial_images=2
를 설정합니다. 부분 이미지가 오면
image_generation.partial_image
이벤트의
b64_json
을 이미지 파일로 저장합니다. 이는 생성 중간의 결과이지 최종 확정 파일은 아닙니다.
Responses API의 이미지 생성 도구 예시는
response.image_generation_call.partial_image
이벤트에서
partial_image_b64
를 읽고,
response.completed
뒤 이미지 생성 호출의
result
를 최종 파일로 저장합니다. 두 API의 이벤트 이름과 데이터 위치를 섞어 쓰면 이미지가 안 보일 수 있습니다.
한 줄 정리: 미리보기는 진행 상황을 보여 주고, 최종 이미지는 완료 뒤 별도로 확인해야 합니다.
바로 따라 해보기
1단계. 사용 중인 API의 예시를 고릅니다.
Image API에서 이미지를 직접 만드는지, Responses API에 이미지 생성 도구를 붙였는지 먼저 확인하세요. 각 예시의 요청 경로와 부분 이미지 이벤트가 다릅니다. 처음에는 작은 테스트 프롬프트와 별도 저장 폴더를 준비합니다.
2단계. 스트림과 부분 이미지 수를 정합니다.
공식 예시처럼 스트리밍을 켜고 중간 이미지를 1장 또는 2장 요청해 보세요. 도착할 때마다 이벤트 종류와 순서를 기록하고, 받은 데이터를 디코딩해 각각 다른 이름으로 저장합니다. Base64 문자열 자체를 이미지 파일이라고 생각하지 마세요.
3단계. 완료 뒤 최종 결과를 대조합니다.
중간 파일과 최종 파일에 다른 이름을 붙입니다. Image API에서는 생성 완료 이벤트를, Responses API에서는 응답 완료와 최종 이미지 결과를 확인하세요. 마지막 파일을 열어 요청한 장면과 글자를 점검한 뒤 사용합니다.
주의할 점
공식 문서는 완성 이미지가 빨리 만들어지면 요청한 중간 이미지보다 적게 올 수 있다고 설명합니다. 중간 이미지가 하나도 없더라도 완료 이벤트와 최종 파일을 먼저 확인하세요. 중간 이미지 개수는 최종 결과 이미지 수를 뜻하지 않습니다.
첫 부분 이미지를 최종 파일 이름으로 저장해 뒤에 오는 결과를 덮어쓰거나, 반대로 미완성 미리보기를 완성본으로 공개합니다.
중간 이미지가 요청한 만큼 오지 않았다는 이유만으로 같은 요청을 반복합니다. 우선 스트림 종료와 오류, 최종 파일을 확인하세요.
Base64 이미지 데이터나 API 키를 공개 로그에 남깁니다. 미리보기 파일에도 원본 입력의 민감한 내용이 비칠 수 있으니 보관과 공유 범위를 따로 점검하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
API를 연결할 때는 공식 웹 문서
Image generation 가이드에서 자신의 API 예시를 고르고 이벤트 이름과 저장 위치를 나란히 확인하세요. 실행은 API를 쓰는 프로그램에서 합니다.
그림만 만들 때는 일반 앱
직접 코드를 연결할 일이 없다면 ChatGPT 앱이나 웹사이트에서 결과를 먼저 만들어 보세요. 앱의 화면 동작과 API 스트림 설정은 별개입니다.
같이 보면 좋은 질문
확인한 공식 자료
OpenAI 공식 가이드 — Image generation — 두 API의 스트리밍 예시와 부분 이미지 수·완료 확인 기준을 확인했습니다.
OpenAI 공식 가이드 — Image generation tool — Responses API 도구의 부분 이미지 이벤트와 최종 이미지 저장 예시를 확인했습니다.
OpenAI API 문서 — Create image — 이미지 생성 요청의 partial-images 값과 스트리밍 응답 의미를 확인했습니다.
감자나라 AI 강의보기 5,000 
