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 패턴).
