kintex/tools/nanobanana/README.md

tools/nanobanana — Gemini 이미지 생성(나노바나나) 연동 모듈

부스/인테리어/배선/조명 설계 데이터를 "시공 후 결과 사진"으로 렌더링한다.

준비

pip install google-genai
export GEMINI_API_KEY=발급받은_키   # https://aistudio.google.com

빠른 시작

from tools.nanobanana.client import NanoBananaClient
c = NanoBananaClient()
img = c.generate_booth_photo({
    "hall": "제1전시장 3홀",
    "size_m": (6, 3),
    "booth_type": "목공부스",
    "brand_color": "#0052A5",
    "materials": ["백색 무광 목공", "우드 포인트월", "그레이 카펫"],
    "lighting": {"color_temp_k": 4000, "accents": ["로고 스포트", "쇼케이스 라인조명"]},
}, view="front", time_of_day="night")
img.save("booth_night.png")

표준 샷 세트 S1~S7 (PLANNING §6 기준, visualizer 에이전트가 관리)

샷	호출	용도
S1 정면 주간	generate_booth_photo(view="front", time_of_day="day")	기본 시안 확인
S2 정면 야간	generate_booth_photo(view="front", time_of_day="night")	조명 연출 평가
S3 통로 뷰	generate_booth_photo(view="aisle")	관람객 시점 동선 평가
S4 내부 뷰	generate_booth_photo(view="interior")	인테리어/집기 배치
S5 Before/After	S1 결과 + reference_image(빈 부스 실측) 쌍	시공 전/후 비교 슬라이더
S6 배선 오버레이	`generate_wiring_overlay(kind="network	power
S7 홀 전경 조감	generate_booth_photo(view="aerial")	배치안 비교(SCR-04)

정책

• 생성 이미지는 "AI 생성 예상 이미지 — 실제 시공 결과와 다를 수 있음" 워터마크를 붙여 서비스에 노출한다 (계약 서류 사용 금지).
• 참조 이미지(빈 부스 실측 사진)를 넣으면 실제 홀 구조를 보존한 합성이 된다 (ReRoomAI 패턴).