개발자가 가장 알고 싶은 답은 보통 “2장인가, 5장인가, 10장인가”입니다. 하지만 현재 검토한 근거만 놓고 보면, GPT Image 2 Edit에서 한 번의 편집 요청에 넣을 수 있는 원본 이미지 수의 공식 숫자 한도는 확인되지 않습니다. OpenAI Images API에는 이미지 편집 메서드가 있고, Python API 레퍼런스는 편집 입력을 “The image(s) to edit”라고 설명합니다. 다만 검토한 OpenAI 공식 레퍼런스들은 편집 요청당 소스 이미지 최대 개수를 숫자로 제시하지 않습니다. [15][
16][
17]
문서 기준으로 말할 수 있는 답
제품 문구, 개발 문서, 유효성 검사 로직에 넣을 수 있는 가장 안전한 표현은 다음에 가깝습니다.
GPT Image 2 Edit 계열 워크플로는 원칙적으로 복수 이미지 입력 형태를 전제로 하지만, 검토한 OpenAI 공식 이미지 편집 문서에는 한 요청당 원본 이미지 수의 숫자 최대치가 문서화되어 있지 않습니다. [
15][
16][
17]
여기서 핵심은 OpenAI Python API 레퍼런스의 “image(s) to edit”라는 표현입니다. [16] 이 문구는 입력이 반드시 단일 이미지로만 제한된다고 보기 어렵게 만듭니다. 그러나 동시에 이 표현이 “최대 10장까지 업로드 가능” 같은 상한을 뜻하는 것은 아닙니다. 그런 숫자는 별도의 제공자 문서나 공식 제한 안내가 있어야 주장할 수 있습니다. [
16]
‘업로드한 원본 이미지’와 ‘생성된 출력 이미지’는 다르다
혼동이 가장 자주 생기는 지점은 이미지 API에 서로 다른 두 가지 개수가 존재한다는 점입니다.
- 원본 이미지 수: 편집 참고용으로 업로드하거나 URL로 전달하는 입력 이미지의 개수
- 생성 이미지 수: 모델이 결과로 반환하는 출력 이미지의 개수
일부 문서는 “이미지 몇 장”이라는 표현을 쓰지만, 그것이 입력 한도인지 출력 개수인지 반드시 구분해야 합니다. 예를 들어 Zenlayer의 OpenAI 호환 이미지 편집 레퍼런스는 “생성할 이미지 수”가 1~10 사이여야 한다고 설명합니다. 이는 출력 설정이지, 편집에 업로드할 수 있는 원본 이미지 수의 상한이 아닙니다. [19]
OpenVINO의 OpenAI 호환 이미지 편집 예시도 같은 차이를 보여줍니다. 예시는 image=@three_cats.png로 파일 하나를 보내고, 별도로 n=4를 사용해 여러 출력 이미지를 요청합니다. 샘플 코드에 원본 파일이 하나만 등장한다고 해서 입력이 1장으로 제한된다는 뜻은 아니며, n=4가 원본 이미지 4장을 받는다는 뜻도 아닙니다. [20]
서드파티 GPT Image 2 Edit 래퍼는 공식 한도를 대신하지 않는다
Fal, WaveSpeedAI 같은 서드파티 제공자 문서는 실제 구현에는 유용할 수 있습니다. 그러나 그 문서가 명시적으로 제한을 밝히지 않는 한, 이를 OpenAI의 공식 최대치로 읽어서는 안 됩니다.
Fal의 openai/gpt-image-2/edit 페이지는 예시 요청에서 image_urls 배열을 보여줍니다. 이는 여러 이미지 URL을 담을 수 있는 형태와는 맞지만, 해당 예시에는 URL이 하나만 들어 있으며 원본 이미지 수의 최대치를 공개하지 않습니다. [2]
WaveSpeedAI는 GPT Image 2 Edit 워크플로가 여러 참고 이미지를 블렌딩할 수 있다고 설명합니다. 다만 이 역시 제공자 설명일 뿐, OpenAI 공식 문서에 적힌 숫자형 원본 이미지 한도는 아닙니다. [22]
ChatGPT 업로드 제한도 별개로 봐야 한다
ChatGPT 화면에서 이미지를 몇 장 올릴 수 있는지와 Images API의 편집 요청 한도는 같은 문제가 아닙니다. OpenAI의 ChatGPT Image Inputs FAQ는 사용자가 ChatGPT 대화에 추가할 수 있는 이미지 수가 이미지 크기 등 여러 요인에 따라 달라진다고 설명합니다. [7] 이 FAQ는 ChatGPT 대화 환경의 동작을 다루고, Images API 레퍼런스는 이미지 편집 메서드를 다룹니다. 둘을 같은 한도로 취급하면 잘못된 유효성 검사 로직이 만들어질 수 있습니다. [
7][
15]
실무에서는 이 차이가 중요합니다. ChatGPT 웹 UI, OpenAI Images API, 그리고 서드파티 래퍼는 각각 다른 파일 크기 제한, 요청 스키마, 런타임 오류 조건을 가질 수 있습니다. 따라서 “GPT Image 2 Edit는 무조건 몇 장”이라고 고정하기보다, 실제 호출하는 시스템의 문서를 기준으로 처리해야 합니다.
개발자가 적용할 만한 원칙
-
제품 문구는 보수적으로 쓰기
제공자가 정확한 숫자를 문서화하지 않았다면 “최대 10장 업로드”보다 “여러 참고 이미지 지원”이 더 안전합니다. [16][
19]
-
입력 수와 출력 수를 분리해서 관리하기
원본 이미지 개수는n, 출력 이미지 수, “images to generate” 같은 생성 개수 파라미터와 별도 필드로 다루는 편이 안전합니다. [19][
20]
-
제공자별 제한을 설정값으로 두기
Fal, WaveSpeedAI 또는 다른 OpenAI 호환 래퍼를 사용한다면 전역 OpenAI 한도를 가정하지 말고, 해당 제공자의 스키마와 실제 오류 응답을 기준으로 제한을 검증해야 합니다. [2][
22]
-
사용자 오류 메시지는 정확하게 쓰기
특정 엔드포인트가 참고 이미지를 너무 많이 받지 못한다면 “이 제공자에서는 현재 최대 N장까지 지원합니다”처럼 안내하는 편이 좋습니다. 이를 “GPT Image 2 Edit의 공식 최대치”라고 표현하는 것은 근거가 부족합니다.
결론
현재 검토한 문서만으로는 “한 번에 몇 장까지 업로드 가능하다”는 숫자 답을 확정할 수 없습니다. OpenAI 이미지 편집 레퍼런스의 “image(s) to edit” 표현은 복수 이미지 입력 가능성을 뒷받침하지만, 한 번의 편집 요청에서 허용되는 원본 이미지 수의 공식 최대치는 문서화되어 있지 않습니다. [15][
16][
17]
