190 lines
7.9 KiB
Markdown
190 lines
7.9 KiB
Markdown
# Higgsfield Shorts Engine
|
||
|
||
> ADO2 마케팅 자동화 파이프라인의 **어텐션 트랙(Attention Track)** 영상 생성 엔진.
|
||
> 펜션 사진 3~5장 → 8초 임팩트 숏츠/릴스 (Higgsfield API 기반).
|
||
|
||
---
|
||
|
||
## 1. Project Goal
|
||
|
||
**한 줄 목표**
|
||
> 펜션 마케팅의 신뢰 기반 콘텐츠를 깨지 않고, **의도적 비현실(Intentional Unreal)** 영상으로 SNS 피드의 Pattern Interrupt를 만들어 평균 시청유지율을 2배 이상 끌어올린다.
|
||
|
||
**왜 지금인가 (Why Now)**
|
||
- 기존 Creatomate 슬라이드쇼는 "실사 보존" 원칙 덕분에 신뢰는 높지만, Instagram/TikTok 피드에서 평균 1.5초 안에 스킵됨
|
||
- 펜션 SNS 피드의 90%는 실사 사진/영상 → 차별화 여지 없음
|
||
- Higgsfield의 카메라 무브·드림시퀀스·시네마틱 모션은 "AI가 만든 티"가 나도 오히려 **궁금증 → 스와이프 정지 → 프로필 진입** 의 깔때기를 형성
|
||
|
||
**전략적 포지셔닝**
|
||
| 트랙 | 엔진 | 역할 | 사용자 인식 |
|
||
|---|---|---|---|
|
||
| Trust Track | `engine/semantic_video/` + Creatomate | 실사 슬라이드쇼·정보 전달 | "이 펜션은 진짜 이렇게 생겼다" |
|
||
| **Attention Track** | **`engine/higgsfield_shorts/` (본 모듈)** | **8초 시네마틱·드림시퀀스** | **"뭐지? 가보고 싶다"** |
|
||
|
||
두 트랙은 **상호 보완** 관계. 어텐션 트랙으로 유입 → 트러스트 트랙으로 전환(예약).
|
||
|
||
---
|
||
|
||
## 2. Success Criteria (KPI)
|
||
|
||
### Primary (어텐션 성과)
|
||
- **평균 시청 유지율** ≥ 65% (8초 기준, 5.2초 이상 시청)
|
||
- **Hook Rate** (3초 시청률) ≥ 35% (업계 평균 15~20%)
|
||
- **저장률** ≥ 2% (Instagram Reels 기준)
|
||
|
||
### Secondary (전환 깔때기)
|
||
- 영상 → 프로필 클릭률 ≥ 4%
|
||
- 프로필 → 예약 페이지 이동 ≥ 1%
|
||
|
||
### Production (운영 효율)
|
||
- 사진 5장 입력 → 8초 영상 출력까지 **자동 파이프라인 ≤ 5분**
|
||
- 1편당 Higgsfield API 비용 ≤ $2 (목표 단가)
|
||
- 클라이언트 1곳당 월 12편 생산 가능 (주 3편 ×4주)
|
||
|
||
### Phase 1 KPI (6주, 2026-05-28 ~ 2026-07-09)
|
||
- **3개 펜션 클라이언트로 파일럿 운영**
|
||
- **편당 평균 도달 ≥ 10,000회 / 평균 시청유지율 ≥ 65% 검증**
|
||
- **컨셉 라이브러리 5종 검증 → 2종 표준화**
|
||
|
||
---
|
||
|
||
## 3. Scope
|
||
|
||
### In Scope (Phase 1)
|
||
- 펜션 정사진 3~5장 → 8초 9:16 (Reels/Shorts) 영상 생성
|
||
- Higgsfield API 연동 (Image-to-Video, Camera Control)
|
||
- 컨셉 라이브러리 (시네마틱·드림시퀀스·하이퍼리얼·트레일러·글리치 등)
|
||
- 한국어 자막/타이포그래피 모션 (Remotion 후처리)
|
||
- Creatomate Trust Track 자산과의 메타데이터 연결 (같은 펜션 = 같은 자산 ID)
|
||
|
||
### Out of Scope (Phase 1)
|
||
- 16:9 가로 영상 (Phase 2: 유튜브 시청자대상)
|
||
- 30초/60초 장형 (Phase 2: 광고 캠페인)
|
||
- 사람(인물) 영상 생성 — 초상권/딥페이크 리스크
|
||
- 음악 자동 매칭 — Phase 1은 큐레이션된 라이브러리에서 수동 선택
|
||
|
||
### Hard Constraints (절대 위반 금지)
|
||
- ❌ **펜션의 위치·구조·시설을 왜곡하지 않는다** (예: 산속 펜션을 바닷가로 합성 X)
|
||
- ❌ **존재하지 않는 어메니티를 합성하지 않는다** (수영장 없는데 수영장 X)
|
||
- ✅ **분위기·시간대·날씨·카메라 무브는 자유롭게 과장 가능** (이게 어텐션 핵심)
|
||
- ✅ **추상화·드림시퀀스·픽션화는 OK** — 단, 영상 후반/캡션에 펜션명 명시
|
||
|
||
> Why: 펜션은 신뢰 기반 마케팅이 필수. "분위기 과장"은 광고 관행 안에 있지만, "사실 왜곡"은 부정경쟁방지법·표시광고법 위반.
|
||
|
||
---
|
||
|
||
## 4. Architecture (How it plugs in)
|
||
|
||
```
|
||
[Tenant Photo Library]
|
||
│
|
||
▼
|
||
┌────────────────────────────────────┐
|
||
│ ADO2 Agent Orchestrator │
|
||
│ ├─ Content Agent: 컨셉 선택 │
|
||
│ └─ Media Agent: 사진 큐레이션 │
|
||
└──────────────┬─────────────────────┘
|
||
│
|
||
┌──────┴──────┐
|
||
▼ ▼
|
||
┌──────────────┐ ┌──────────────────────┐
|
||
│ Trust Track │ │ Attention Track │
|
||
│ semantic_ │ │ higgsfield_shorts │
|
||
│ video + │ │ (this engine) │
|
||
│ Creatomate │ │ │
|
||
└──────┬───────┘ └──────────┬───────────┘
|
||
│ │
|
||
│ ┌─────────────────┘
|
||
▼ ▼
|
||
┌────────────────────┐
|
||
│ Distribution Agent │ → Instagram / TikTok / Naver
|
||
└────────────────────┘
|
||
```
|
||
|
||
**모듈 내부 흐름**
|
||
```
|
||
inputs/{tenant}/{shoot_id}/*.jpg
|
||
│
|
||
▼
|
||
src/curation/ # 3~5장 선별 (구도·색감·서사 점수)
|
||
│
|
||
▼
|
||
src/concepts/ # 컨셉 라이브러리에서 매칭
|
||
│
|
||
▼
|
||
src/prompts/ # Higgsfield 프롬프트 빌더
|
||
│
|
||
▼
|
||
src/rendering/ # Higgsfield API 호출 + 비동기 큐
|
||
│
|
||
▼
|
||
src/post/ # Remotion 자막·로고·CTA 합성
|
||
│
|
||
▼
|
||
outputs/{tenant}/{shoot_id}/{concept}.mp4
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Folder Structure
|
||
|
||
```
|
||
engine/higgsfield_shorts/
|
||
├── README.md # 본 문서 (Project Charter)
|
||
├── _brief/
|
||
│ ├── 01_creative-direction.md # 크리에이티브 디렉션 (가짜OK 전략)
|
||
│ ├── 02_goals-kpis.md # 상세 KPI 및 측정 방법
|
||
│ └── 03_scope-constraints.md # 법적·브랜드 제약
|
||
├── concepts/ # 컨셉 라이브러리
|
||
│ ├── README.md
|
||
│ ├── 01_cinematic-trailer.md
|
||
│ ├── 02_dream-sequence.md
|
||
│ ├── 03_hyperreal-luxury.md
|
||
│ ├── 04_time-warp.md
|
||
│ └── 05_anime-painterly.md
|
||
├── prompts/ # Higgsfield 프롬프트 템플릿
|
||
│ └── README.md
|
||
├── inputs/ # 테스트용 펜션 사진 셋
|
||
│ └── .gitkeep
|
||
├── outputs/ # 렌더링 결과
|
||
│ └── .gitkeep
|
||
├── configs/ # Higgsfield API·렌더 파라미터
|
||
│ └── higgsfield.yaml
|
||
├── docs/
|
||
│ └── pipeline-integration.md # ADO2 파이프라인 연동 스펙
|
||
└── tests/
|
||
└── README.md
|
||
```
|
||
|
||
---
|
||
|
||
## 6. Phase 1 Roadmap (6 weeks)
|
||
|
||
| Week | 마일스톤 |
|
||
|---|---|
|
||
| W1 (5/28-6/3) | 컨셉 라이브러리 5종 작성 + Higgsfield API 계정 셋업 + 첫 사진셋 수집 |
|
||
| W2 (6/4-6/10) | 프롬프트 템플릿 v0.1 + 수동 렌더 3편 (컨셉별 PoC) |
|
||
| W3 (6/11-6/17) | 파일럿 펜션 3곳 선정 + 사진 큐레이션 SOP |
|
||
| W4 (6/18-6/24) | 9편 발행 (펜션 3 × 컨셉 3) + 측정 |
|
||
| W5 (6/25-7/1) | 결과 분석 + 컨셉 2종 표준화 |
|
||
| W6 (7/2-7/9) | 자동화 파이프라인 v0.1 (Content Agent 통합) |
|
||
|
||
---
|
||
|
||
## 7. Stakeholders
|
||
|
||
- **Creative Director / Head of Marketing Ops**: 컨셉 디렉션, KPI 책임 (= 사용자)
|
||
- **Engineering**: 엔진 구현, API 연동
|
||
- **Pilot Clients**: 펜션 3곳 (5월 KPI Success Case와 연계)
|
||
|
||
---
|
||
|
||
## 8. Open Questions
|
||
|
||
이 프로젝트가 출발하려면 다음 결정이 필요합니다 (`_brief/01_creative-direction.md` 참고):
|
||
|
||
1. **Phase 1에서 우선 검증할 컨셉 2~3종은?** (라이브러리 5종 중)
|
||
2. **사진 큐레이션 기준** — AI 자동 큐레이션 vs 사람 큐레이션 vs 하이브리드?
|
||
3. **펜션명/CTA 노출 시점** — 영상 마지막 1초 vs 캡션에만 vs 둘 다?
|
||
4. **음악 라이브러리 선택** — Epidemic Sound vs Artlist vs SUNO 자동 생성?
|