Detail Page Image

상세페이지 이미지 합성 (Detail Page Image Composer)

개요

13섹션 감정여정 상세페이지 이미지를 생성하고 세로 합성 PNG로 만드는 스킬입니다.

moai-media:higgsfield-image를 백엔드로 사용하여 카테고리별 비주얼 톤이 일관된 13장의 섹션 이미지를 만들고,

Pillow 단일 의존성으로 1080×12720 단일 합성 이미지를 산출합니다.

트리거 키워드

상세페이지 이미지, 상폐 이미지, 13섹션 이미지, 1080 12720, 상세페이지 합성, 상품 상세 이미지,

combined.png, 상폐 합성본, 이커머스 이미지 합성

사전 조건

• Pillow 설치: pip install Pillow 또는 uv pip install Pillow
• Python 3.10+ 환경
• 다른 의존성 없음 (NumPy 불필요)

• moai-media 플러그인 활성화: 13섹션 이미지 생성에 higgsfield-image 사용
• 또는 사용자가 별도로 13장의 섹션 이미지를 준비해서 폴더 경로 제공

• 상품 사진 1-14장: 실제 상품 레퍼런스 (옵션이지만 권장)

워크플로우

1단계: 입력 수집

다음을 확보합니다:

• 13섹션 카피 JSON (detail-page-copy 스킬 출력)
• 상품 사진 1-14장 경로
• 카테고리 (electronics/fashion/food/beauty/home/supplement/pet/kids/handmade/general)
• ProductDNA (선택, product-photo-brief 스킬 출력)
• 출력 디렉토리 (기본: ./commerce-output/{job_id}/)

2단계: 13섹션 이미지 프롬프트 생성

각 섹션의 카피와 카테고리 비주얼 브리프를 합쳐 higgsfield-image 프롬프트를 작성합니다.

references/image-prompts.md 참조 (섹션별 비주얼 언어, 합성 가이드).

각 섹션은 고유한 비주얼 언어를 가집니다:

• Hero: cinematic_product_portrait — 풀블리드 + 드라마틱 림라이트
• Pain: emotional_photography_no_product — 어두운 톤, 상품 미노출
• Problem: clinical_infographic — 깔끔한 인포그래픽
• Story: editorial_split_before_after — Before/After 좌우 분할
• Solution: product_beauty_shot — 스튜디오 뷰티샷
• How: illustrated_step_sequence — 3단계 일러스트
• Proof: magazine_spread — 매거진 스프레드
• Authority: portrait_with_quote — 인물 포트레이트 + 인용
• Benefits: icon_grid_with_lifestyle — 아이콘 그리드 + 라이프스타일
• Risk: document_with_seal — 문서·인증 스타일
• Compare: split_screen_vs — 50/50 분할 비교
• Filter: checklist_visual — 체크리스트 시각화
• CTA: urgent_product_reveal — 긴급성 + 가격 강조

3단계: 이미지 생성 (moai-media:higgsfield-image)

생성 전략:

• 각 섹션 너비: 1080px
• 섹션별 높이: references/sections-spec.md 표 참조 (Hero 1600-Filter 700)
• 카테고리 비주얼 브리프(electronics/fashion/...) 모든 프롬프트에 주입
• 상품 레퍼런스 사진을 higgsfield-image의 image-to-image 모드로 전달

생성 결과를 output_dir/{job_id}/sections/01_hero.png 부터 13_cta.png 까지 저장.

생성 실패 시: 해당 섹션은 다크 플레이스홀더(40,40,40)로 채워 합성을 진행합니다.

4단계: 1080×12720 합성 (scripts/compose.py)

python scripts/compose.py \
  --sections-dir ./commerce-output/{job_id}/sections/ \
  --output ./commerce-output/{job_id}/combined.png

스크립트 동작:

• 13장 섹션 PNG를 순서대로 로드
• 각 섹션을 표준 너비 1080으로 리사이즈 (비율 유지 + 중앙 크롭)
• 섹션별 표준 높이로 조정
• 세로로 이어붙여 1080×12720 단일 PNG 생성
• 누락된 섹션은 (40,40,40) 다크 플레이스홀더로 대체

상세 알고리즘은 scripts/compose.py와 scripts/README.md 참조.

5단계: 출력 보고

{
  "job_id": "a1b2c3d4",
  "output_dir": "/abs/.../commerce-output/a1b2c3d4",
  "combined": "/abs/.../combined.png",
  "sections": [
    "/abs/.../sections/01_hero.png",
    "...",
    "/abs/.../sections/13_cta.png"
  ],
  "failed_sections": [],
  "elapsed_sec": 0,
  "size": "1080x12720"
}

failed_sections가 비어있지 않으면 사용자에게 다음을 안내:

• 어떤 섹션이 실패했는지
• 같은 --output --job-id로 재실행 시 자동 재개되는지 (재개는 사용자가 수동으로 해당 섹션만 재생성)

출력 파일 구조

./commerce-output/{job_id}/
├── analysis.json              # 13섹션 카피 + 프롬프트 + ProductDNA
├── sections/                   # 13장 섹션 (1080×가변)
│   ├── 01_hero.png            (1080×1600)
│   ├── 02_pain.png            (1080×800)
│   ├── ...
│   └── 13_cta.png             (1080×900)
└── combined.png                # 1080×12720 세로 합성본

scripts/compose.py 사용법

자세한 사용법은 scripts/README.md 참조. 핵심 명령:

# 13장이 sections/ 폴더에 01_hero.png ~ 13_cta.png로 있을 때
python scripts/compose.py \
  --sections-dir ./commerce-output/abc12345/sections/ \
  --output ./commerce-output/abc12345/combined.png

옵션:

• --width INT: 출력 너비 (기본 1080)
• --placeholder-color "R,G,B": 누락 섹션 플레이스홀더 색 (기본 "40,40,40")
• --quiet: 진행 로그 억제

사용 예시

• "이 카피 결과로 13섹션 이미지 합성해줘"
• "상품사진 5장으로 상세페이지 1080 12720 만들어줘"
• "electronics 카테고리, 무선 이어폰 상세페이지 이미지 풀세트"

관련 스킬

• moai-commerce:detail-page-copy — 13섹션 카피 생성 (이 스킬 입력)
• moai-commerce:product-photo-brief — 상품 사진 사전 분석
• 13섹션 이미지 생성 — Higgsfield MCP(Soul·시네마틱 이미지·캐릭터) 직접 호출
• moai-commerce:marketplace-coupang — 채널별 이미지 규격 가이드

이 스킬을 사용하지 말아야 할 때

• 카피만 필요할 때: detail-page-copy 단독 사용
• 단일 상품 컷만 필요할 때: Higgsfield MCP 직접 호출
• 영상 생성: Higgsfield MCP(DOP·Soul) 직접 호출
• shadcn/ui 기반 웹 상세페이지: moai-content:product-detail

라이선스

MIT.