직접 테스트해 볼 가치가 있는 이유
참조 이미지 14장은 극단적인 시나리오입니다. 일상적인 사용에서는 이런 상황을 만나지 않을 수 있지만, 서로 독립적으로 설계된 여러 요소를 하나의 합성물(포스터, 캠페인 비주얼 등)로 합쳐야 한다면 두 가지를 확인해야 합니다.- 실제로 호출이 성공합니까? 14장의 이미지를 쌓으면 요청 본문이 눈에 띄게 커집니다. 너무 커서 거부되지는 않습니까?
- 융합 결과가 합리적입니까? 입력 이미지가 그렇게 많을 때 모델이 일부를 누락하거나, 요소를 잘못 배치하거나, 서로 섞어 버리지는 않습니까?
방법 1: 객관적 마커 테스트(먼저 수행하십시오)
아이디어: 복잡한 실제 장면 대신, 시각적으로 구분되고 개별적으로 셀 수 있는 N장의 카드를 생성합니다. 가장 간단한 버전은 1부터 14까지의 숫자입니다. 그런 다음 모델에게 이들을 하나의 이미지로 콜라주/융합하도록 요청합니다.- 각 카드에 완전히 다른 색상 구성과 재질 스타일(네온 튜브, 브러시드 메탈, 분필 손글씨, 픽셀 아트, 조각된 나무 등)을 부여하여, 융합된 결과에서 모든 숫자가 색상과 스타일만으로 원래 카드까지 추적될 수 있도록 하십시오;
- 융합 후에는 그냥 눈으로 확인하십시오: 14개의 숫자가 모두 있고, 중복이나 누락이 없는가? “보기 좋은가”를 판단할 필요는 없고, 오직 “완전하고 정확한가”만 보면 됩니다.

14 visually distinct number cards fused into a single poster: 1–14 all clearly legible, each retaining the color and material style of its source image
방법 2: 실제 시나리오 분해 테스트
아이디어: 만들고자 하는 실제 장면을 N개의 독립된 요소로 분해해 각각 따로 생성한 다음, 모델이 이를 다시 하나의 장면으로 합치게 하는 방식입니다. 이는 실제 사용에 더 가깝습니다. 예를 들어 캐릭터, 의상, 소품, 배경을 각각 따로 관리한 뒤 최종 샷으로 합성하는 방식입니다. 예를 들어, 우리는 패션 에디토리얼 장면을 14개의 독립된 요소로 분해했습니다. 모델 초상, 아우터, 차량, 배경, 반려동물/액세서리, 가방, 주얼리, 신발, 여행 가방 등이 포함되며, 각각은 일관된 스타일 기준(예: 모두 “밝은 회색 스튜디오 배경, 사실적인 사진”)을 적용한 독립 이미지로 생성됩니다.
14 independently generated fashion elements (model, outfit, car, pet, bag, accessories, etc.) fused into a single fashion editorial scene — all elements present, composition coherent
요청 형식: 한 번의 요청에 이미지 14개 넣기
Gemini의 네이티브 형식에서는 멀티 이미지 융합 규칙이 간단합니다: 하나의text 부분(융합 지시문) + N개의 inlineData 부분(참조 이미지마다 하나씩). 각 부분은 text 또는 inlineData일 수 있을 뿐이며, 둘 다 동시에 될 수는 없습니다.
parts 구조, 흔한 오류)에 대해서는 Image Edit API 레퍼런스와 Nano Banana 시리즈 개발자 가이드를 참고하십시오.
고객이 가장 궁금해하는 질문: 대형 요청은 거부됩니까?
압축되지 않은 원본 이미지 14장을 보내면 요청 본문이 눈에 띄게 커집니다. 실제 수치를 바탕으로 한 실험도 진행했습니다(2K 해상도 이미지 14장, 압축 없음):APIYI의 요청당 이미지 페이로드 상한은 100MB입니다(과도한 메모리 사용을 피하기 위한 동기 호출 기준입니다). 단일 이미지는 Google의 공식 규칙인 7MB 이하를 따릅니다. 2K 해상도 14장의 총합은 42–43MB였으므로 두 제한 모두 한참 이내였고, 요청은 문제없이 처리되었습니다.
이미지가 돌아오지 않으면 먼저 안전 차단 여부를 확인하세요
멀티 이미지 융합 작업은 때때로finishReason: IMAGE_SAFETY에 걸립니다(HTTP 상태는 여전히 200이지만, content.parts은 비어 있습니다). 테스트에서는 완전히 같은 입력을 한두 번 다시 시도하면 성공하는 경우가 많습니다. 이런 차단은 어느 정도 무작위성이 있으며, 반드시 입력에 실제 문제가 있다는 뜻은 아닙니다.
빠른 참고
- Google의 공식 한도는 요청당 참조 이미지 14개입니다. APIYI는 이를 완전히 지원하는 것으로 검증했으며, 호출은 성공하고 결합 결과도 일관적입니다.
- 직접 테스트할 때는 두 가지 방법 모두 실행하십시오. 숫자 카드 테스트는 완전성을 검증하고, 실제 시나리오 분해 테스트는 결합 품질을 검증합니다.
- 2K 기준 원본 이미지 14장은 총 약 40MB입니다. APIYI의 100MB 요청 한도와 Google의 이미지당 7MB 제한을 충분히 밑돌기 때문에 거부되지 않습니다. 더 빠른 처리를 위해서는 압축을 권장합니다.
- 다중 이미지 요청 구조: 1개의 text part + N개의 inlineData part입니다. 같은 part 안에 둘을 함께 넣지 마십시오.
IMAGE_SAFETY와 함께 빈 이미지가 돌아오면 먼저 한두 번 다시 시도하십시오. 종종 성공하며, 차단된 이미지는 과과금되지 않습니다.