40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# tools/nanobanana — Gemini 이미지 생성(나노바나나) 연동 모듈
|
|
|
|
부스/인테리어/배선/조명 설계 데이터를 "시공 후 결과 사진"으로 렌더링한다.
|
|
|
|
## 준비
|
|
```bash
|
|
pip install google-genai
|
|
export GEMINI_API_KEY=발급받은_키 # https://aistudio.google.com
|
|
```
|
|
|
|
## 빠른 시작
|
|
```python
|
|
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|plumbing")` | 발표/설명용 보조 이미지 (시공 검증은 백엔드 래스터 합성 사용) |
|
|
| S7 홀 전경 조감 | `generate_booth_photo(view="aerial")` | 배치안 비교(SCR-04) |
|
|
|
|
## 정책
|
|
- 생성 이미지는 "AI 생성 예상 이미지 — 실제 시공 결과와 다를 수 있음" 워터마크를 붙여 서비스에 노출한다 (계약 서류 사용 금지).
|
|
- 참조 이미지(빈 부스 실측 사진)를 넣으면 실제 홀 구조를 보존한 합성이 된다 (ReRoomAI 패턴).
|