솔라피 시작하기

가이드

나노 바나나 (NanoBanana)

작성일 2026.03.20 | 수정일 2026.03.20

나노 바나나 (NanoBanana)

Gemini API를 사용하여 텍스트 프롬프트로 AI 이미지를 생성하는 노드입니다. 참조 이미지 입력, 텍스트 오버레이, IMAGE_SAFETY 자동 프롬프트 수정 등 고급 기능을 제공합니다.

주요 기능

Operation	설명
Generate Image	텍스트 프롬프트로 AI 이미지 생성

설정 항목

기본 설정

항목	타입	기본값	설명
Prompt	string	-	생성할 이미지에 대한 텍스트 설명 (필수)
Reference Image URL	string	-	AI 컨텍스트로 사용할 참조 이미지 URL (쉼표/줄바꿈으로 여러 개 입력 가능)
Random Image Selection	boolean	`false`	참조 이미지 중 랜덤으로 하나만 선택
Model	options	`gemini-2.5-flash-image`	이미지 생성 모델
Aspect Ratio	options	`1:1`	가로세로 비율
Response Format	options	`binaryData`	응답 형식 (Binary Data / JSON Only)
Binary Property Name	string	`data`	바이너리 데이터 속성 이름

지원 모델

모델	설명
`gemini-3.1-flash-image-preview`	빠르고 비용 효율적인 최신 모델
`gemini-3-pro-image-preview`	고품질 이미지 생성 모델
`gemini-2.5-flash-image`	이전 버전 이미지 생성 모델

가로세로 비율

비율	해상도	용도
`1:1`	1024x1024	정사각형
`16:9`	1344x768	와이드 (유튜브 썸네일)
`9:16`	768x1344	세로 (인스타그램 스토리)
`3:2`	1248x832	가로 사진
`2:3`	832x1248	세로 사진
`4:3`	1184x864	표준 가로
`21:9`	1536x672	울트라 와이드

추가 옵션

항목	타입	기본값	설명
재시도 횟수	number	`3`	실패 시 재시도 횟수 (0~10)
재시도 지연(초)	number	`2`	재시도 간 대기 시간 (0~30)
타이틀	string	-	이미지 위에 표시할 텍스트 (비워두면 오버레이 건너뜀)
폰트 크기	number	`88`	타이틀 폰트 크기 (20~200 px)
텍스트 색상	string	`#ffffff`	타이틀 텍스트 색상
텍스트 외곽선 사용	boolean	`true`	외곽선 표시 여부
외곽선 색상	string	`#000000`	외곽선 색상
외곽선 두께	number	`8`	외곽선 두께 (0~30 px)
볼드 폰트 파일 경로	string	-	커스텀 폰트 파일 경로
IMAGE_SAFETY 시 자동 프롬프트 수정	boolean	`false`	안전성 위반 시 Gemini로 프롬프트 자동 수정
프롬프트 수정용 모델	options	`gemini-2.5-flash`	프롬프트 수정에 사용할 모델
최대 프롬프트 수정 횟수	number	`2`	프롬프트 수정 최대 시도 횟수 (1~5)

인증 정보

Gemini API 키가 필요합니다. 자세한 설정 방법은 Gemini API 인증 설정 가이드를 참고하세요.

사용 예시

블로그 포스트 이미지 자동 생성

AI 노드에서 블로그 글의 이미지 프롬프트를 생성합니다.
NanoBanana 노드에서 프롬프트를 받아 이미지를 생성합니다.
AWS S3에 업로드하여 블로그에 삽입합니다.

유튜브 썸네일 배경 이미지 생성

NanoBanana에서 Aspect Ratio를 16:9로 설정합니다.
영상 주제에 맞는 프롬프트를 입력합니다.
타이틀 옵션으로 이미지 위에 텍스트를 직접 오버레이하거나, MakeThumbnail 노드에 전달합니다.

참조 이미지 기반 일관된 스타일 생성

Reference Image URL에 기존 스타일 이미지 URL을 입력합니다.
프롬프트에 "이 스타일을 유지하면서..." 등의 지시를 추가합니다.
Random Image Selection을 활성화하면 여러 참조 이미지 중 하나가 랜덤으로 선택됩니다.

참고 사항

IMAGE_SAFETY 오류가 발생하면 Google 정책에 의해 이미지 생성이 차단된 것입니다. "자동 프롬프트 수정" 옵션을 활성화하면 Gemini Text Gen을 사용하여 프롬프트를 자동으로 수정하고 재시도합니다.
텍스트 오버레이 기능은 Canvas 기반으로 동작하며, 이미지 중앙에 텍스트가 배치됩니다.
참조 이미지는 HTTPS URL만 지원합니다.
응답에 토큰 사용량(_usage)이 포함되어 비용 추적이 가능합니다.
continueOnFail 설정이 활성화된 경우, 이미지 생성 실패 시 에러 정보를 JSON으로 반환하고 워크플로우를 계속 진행합니다.