assets/README.md

assets 폴더 — 레퍼런스 이미지 배치 가이드

이 폴더에 넣은 이미지는 app.py가 자동으로 읽어 생성에 참조합니다.

1. 모델 얼굴 프리셋 (필수)

assets/model_face_preset.png

• 모든 생성에서 얼굴 정체성(identity) 의 기준이 됩니다. (항상 reference image 1)
• 화면에서 업로드 얼굴을 선택하지 않으면 이 프리셋이 쓰입니다.

2. 모델 체형 레퍼런스 (선택)

assets/model_body_preset.png

• 전신 후보 생성 시 추가 레퍼런스로 들어가며, 체형/비율(키 인상, 골격, 어깨너비, 팔다리 비율, 머리-몸 비율)만 차용합니다.
• 이 이미지의 얼굴·헤어·피부톤·의상·포즈·배경은 무시하도록 프롬프트에 명시돼 있습니다. (얼굴은 1번 얼굴 프리셋에서 옴)
• 이 레퍼런스가 있으면 그 비율을 그대로 맞추고, 없으면 중립 비율로 생성합니다. (IDEALIZE_PROPORTIONS=true로 8.2~8.5등신 강제도 가능)
• 전신 후보의 크롭·프레이밍 기준으로도 쓰입니다. (전신_앞면_ 레퍼런스가 있으면 그쪽이 우선)
• (API에 model_body 업로드 필드도 열려 있어, 추후 UI에 업로드 버튼을 붙이면 프리셋 대신 그때그때 올릴 수 있습니다.)

3. 샷별 레퍼런스 (선택) — assets/poses/

각 샷 버튼은 assets/poses/의 레퍼런스 이미지 1장과 1:1로 연결됩니다. 파일명 = 샷 라벨에서 괄호를 밑줄(_)로 바꾼 형태이며, 확장자는 png/jpg/jpeg/webp 모두 가능합니다.

샷 버튼	파일명	노출 카테고리
전신(앞면)	assets/poses/전신_앞면_.*	상의·하의 공통
전신(측면)	assets/poses/전신_측면_.*	상의·하의 공통
전신(후면)	assets/poses/전신_후면_.*	상의·하의 공통
상반신(앞면)	assets/poses/상반신_앞면_.*	상의·하의 공통
상반신(측면)	assets/poses/상반신_측면_.*	상의·하의 공통
상반신(후면)	assets/poses/상반신_후면_.*	상의 전용
상반신(클로즈업)	assets/poses/상반신_클로즈업_.*	상의 전용
디테일(후면)	assets/poses/디테일_후면_.*	상의 전용
하반신	assets/poses/하반신.*	하의 전용
하반신(클로즈업)	assets/poses/하반신_클로즈업_.*	하의 전용

(카테고리 → 버튼 구성: 상의·원피스·아우터 = 상의 세트 8개, 하의·스커트 = 하의 세트 7개)

레퍼런스가 정하는 것 / 정하지 않는 것

• 정함: 포즈, 카메라 각도, 정면/측면/후면 방향, 크롭·프레이밍.
• 정하지 않음: 얼굴(=1번), 체형/비율(=2번 또는 베이스 컷), 의상(=제품 이미지·선택한 베이스 컷).

동작 방식

• 샷 버튼 클릭 시, 그 라벨에 정확히 일치하는 파일을 자동으로 끼워넣습니다. (옛 full-01.png / upper-01.jpg / lower-01.jpg 카테고리 방식은 더 이상 사용하지 않으니 삭제해도 됩니다.)
• 전신·상반신(앞/측/후)·하반신 샷은 생성 후 해당 레퍼런스의 세로 프레이밍에 맞춰 자동 크롭됩니다.
• 디테일(후면)·상반신(클로즈업)·하반신(클로즈업) 같은 극단적 크롭은 자동 크롭을 건너뛰고 레퍼런스+프롬프트로만 유도합니다.
• 파일이 없으면 해당 샷은 레퍼런스 없이(포즈·크롭 강제 없이) 생성됩니다.

한계: 포즈/각도는 ControlNet 같은 강제 조건이 아니라 근사 참조라 100% 동일하진 않습니다. 크롭/프레이밍은 후처리로 정확히 맞춰집니다(클로즈업·디테일 제외).