Skip to main content

​
간단한 답변

이것은 Google Aistudio API의 알려진 문제입니다. 계산 압박이 높을 때 생성된 이미지의 큰 순백색 영역은 검은 점, 더러운 얼룩, 또는 흐릿한 색 블록으로 렌더링되는 경향이 있습니다. 2026년 4월 이후로 반복적으로 관찰되었습니다. 해결 방법은 두 가지입니다.
  • 옵션 1(먼저 시도하십시오): 프롬프트를 “흰색 배경”에서 연한 색조(연회색, 베이지, 부드러운 파란색)로 바꾸십시오. 설정 변경은 필요 없습니다.
  • 옵션 2: 지원팀에 문의하여 VertexGemini 그룹을 활성화한 다음, 해당 그룹에 바인딩된 token을 생성하십시오. Vertex 채널은 깨끗한 순백 배경을 생성합니다.

​
자세한 설명

부하가 걸리면 Aistudio 이미지 파이프라인은 큰 단색 영역을 압축하고 재구성하는 데 문제가 있습니다. 특히 순백색에서 이런 현상이 두드러집니다. 흔한 아티팩트는 세 가지입니다:
  • 검은 점 / 더러운 얼룩: 이미지에 국소적으로 나타나는 어두운 점이나 불규칙한 얼룩입니다
  • 흐릿한 색 블록: 순백색 대신 흐릿한 회색빛 또는 노란빛 영역이 나타납니다
  • 색 편차: 흰 배경이 프롬프트와 비교해 따뜻한 베이지색이나 차가운 회청색으로 치우칩니다
이 문제는 모델 성능 문제가 아닙니다 — 단색 배경에서 발생하는 Aistudio 파이프라인의 렌더링 결함입니다. Nano Banana Pro와 Nano Banana 2와 같은 Gemini 이미지 모델은 Aistudio를 통해 라우팅될 때 모두 영향을 받습니다.

​
해결 단계

​
옵션 1: 프롬프트 수준 우회 방법(먼저 권장)

프롬프트에서 “흰 배경 / 순백 배경 / #FFFFFF”를 옅은 색조로 바꿉니다:
  • 연한 회색: light gray background / #F5F5F5
  • 베이지: beige background / #F5F0E5
  • 부드러운 파란색: light blue background / #E8F0F8
  • 투명: transparent background (모델이 알파 출력을 지원하는 경우)
실제로 순백에서 연한 회색이나 베이지로 바꾸면 검은 점과 더러운 얼룩이 거의 완전히 사라집니다. 피사체 색상은 영향을 받지 않습니다 — 배경 색조만 바뀝니다.

​
옵션 2: Vertex 채널로 전환

사용 사례에서 순백 배경이 반드시 필요하다면(예: 이커머스 상품 촬영), Vertex를 통해 라우팅하면 근본 원인을 해결할 수 있습니다.

​
VertexGemini 그룹 참조

​
사용 방법

1

지원팀에 접근 권한 요청

APIYI 지원팀 / 운영팀에 연락하여 VertexGemini 그룹을 활성화하십시오. 현재는 초대 전용입니다.
2

전용 token 생성

APIYI 콘솔에 로그인 → Token management → Create token → 그룹 **VertexGemini**를 선택 → 키를 저장합니다.
3

호출 전환

새 token으로 Nano Banana Pro / Nano Banana 2를 호출합니다. 기본 URL은 동일합니다(https://api.apiyi.com/v1).
VertexGemini 그룹은 동시 실행 수가 제한적이므로(~100 RPM), 고처리량 운영 워크로드에는 권장하지 않습니다. Aistudio를 기본 채널로 유지하고, 순백 배경 테스트에만 Vertex로 전환하십시오.

​
자주 묻는 질문

Aistudio 렌더링 문제는 큰 단색 영역을 압축할 때 발생합니다. 연한 회색이나 베이지색으로 바꾸면 배경에 약간의 질감이 생겨, 아티팩트를 유발하는 “큰 균일 영역 압축” 조건을 피할 수 있습니다.
꼭 그렇지는 않습니다. Vertex는 순백색 / 단색 배경에서 더 안정적이지만, 다른 장면(복잡한 구도, 인물 사진)에서는 두 서비스가 비슷하며 Vertex가 더 느립니다. 문제가 순백색 때문에 발생한다고 확인된 경우에만 전환하십시오.
초대 전용입니다. APIYI 지원팀이나 계정 관리자에게 문의하십시오. 대부분의 사용자에게는 옵션 1(옅은 색조의 배경으로 전환)만으로 충분합니다.
아닙니다. Base URL은 https://api.apiyi.com/v1로 유지됩니다. 바뀌는 것은 token의 그룹뿐이며, APIYI의 백엔드가 Vertex 그룹 트래픽을 Vertex 플랫폼으로 자동 라우팅합니다.

​
관련 문서

Nano Banana 이미지 실패

Nano Banana 이미지 모델에서 자주 발생하는 문제와 해결 방법입니다.

Google AI Studio vs Vertex 채널

AI Studio와 Vertex Gemini 이미지 채널의 차이점과 선택 방법입니다.

엔터프라이즈 Vertex 대체 그룹

엔터프라이즈 고객이 Vertex 그룹을 대체 채널로 사용하는 방법입니다.

이미지 비동기 API

비동기 이미지 생성 엔드포인트를 사용하는 방법입니다.