Product Photo AI
모든 이미지 생성 및 편집은 scripts/gen.py를 통해 이루어집니다. PIL/rembg로 직접 합성하지 말고, 다른 이미지 도구를 사용하지 마세요.
GEN="${CLAUDE_SKILL_DIR}/scripts/gen.py"
python3 "$GEN" --credits
python3 "$GEN" --prompt-file p.txt --refs photo.jpg --format vertical --out out.png
python3 "$GEN" --model black-forest-labs/flux.2-max --prompt-file p.json --refs photo.jpg --format auto --no-upsample --out out.png
머신에 따라 python3 대신 python을 사용하세요. 표준 라이브러리만 사용합니다.
모델
| 모델 | 사용 시기 | 비용 / 시간 |
|---|---|---|
| Nano Banana 2.1 (기본값) | 사용자의 실제 사진 편집: 조명, 분위기, 소품, 계절감 | 2K 기준 ~$0.055 · 약 20초 |
FLUX.2 Max (--model black-forest-labs/flux.2-max) | 텍스트로 이미지 처음부터 생성, JSON/hex로 세밀한 제어, --seed로 레이아웃 반복, 또는 Nano가 두 번 실패했을 때 | 2MP 기준 ~$0.16, 4MP 기준 ~$0.22 · 30–50초 |
이유: 블라인드 테스트(4개 사례, 4개 모델)에서 Nano Banana 2.1은 승자가 있는 모든 사례에서 1위를 차지했으며 "AI처럼 보인다"는 평가를 받지 않은 유일한 모델이었습니다. FLUX.2 Max는 4개 사례 모두에서 지적되었습니다. 자세한 내용: references/realism.md → History.
설정
- 키는
OPENROUTER_API_KEY또는~/.openrouter-key에 저장됩니다(사용자가 생성). 절대 출력하거나, echo로 표시하거나,curl명령어에 넣지 마세요. - 호출은 20~140초가 소요됩니다: Bash 타임아웃을 길게 설정하거나(예: 600000 ms) 백그라운드에서 실행하세요.
- 배치 실행 전:
--credits를 실행하여 잔액과 예상 비용을 표시하세요. 배치 비용이 약 $1을 초과하면 사용자에게 확인을 받으세요.in_flight없이HTTP 402가 발생하면 크레딧 부족입니다: 그렇게 알리고, 재시도하지 말고, 프롬프트를 저장하세요. - 여러 변형: 변형당
gen.py하나씩 병렬로 실행하되, 잔액이 적을 때는 최대 2~3개까지만 실행하세요(OpenRouter에서402 in_flight_budget_exhausted로 차단함). 각 종료 코드와 stderr를 보고하세요.
결정
| 사례 | 방법 |
|---|---|
| 형식 | 일반적인 형식: vertical (9:16, 스토리) 및 square (1:1). 명시되지 않은 경우 묻거나 vertical로 전달하세요 |
| 사용자 제품 사진 | --refs + 요청된 형식. 비율이 사진과 다른 경우, 모델이 장면을 확장합니다: extend the scene naturally to fill the frame, keeping the product the same size and centered 추가 (Nano 3:4 → 9:16 및 1:1에서 테스트됨). 사진 비율을 유지하려면 --format auto만 사용하세요 |
| Instagram 피드 | --format insta (4:5) |
| 사진 없음 | 텍스트로 이미지 생성, JSON과 함께 FLUX.2 Max 사용 |
| 제품 모양/높이 변경 | 전체 제품을 설명하는 텍스트로 이미지 생성 (편집은 비율을 유지함) |
| 나중에 다른 형식 | 다른 --format으로 재생성; 절대 자르지 마세요 |
스크립트 플래그
--format:vertical9:16 (기본값) ·insta4:5 ·portrait3:4 ·tall2:3 ·square1:1 ·classic4:3 ·landscape16:9 ·wide21:9 ·auto(첫 번째 참조의 비율).- Nano: 2K 출력; 시드 없음 (실행마다 다름). API에서 최대 14개 참조, 스크립트를 통해 8개.
- FLUX.2 Max:
--quality auto|hi|std(약 4MP/약 2MP;auto는 참조 0–2개인 경우 hi).--no-upsample은 BFL의 프롬프트 재작성기를 끕니다: 편집 시 항상 사용하세요 (더 충실함).--seed N은 레이아웃을 반복합니다. 참조가 6개를 초과하면--size 1024x1024(최대 8개). - stdout은 실제
cost_usd와seed가 포함된 한 줄의 JSON입니다.
Nano Banana 2.1 프롬프팅 (편집)
Nano는 명령 모델입니다: JSON이 아닌 산문 형식으로 사진 편집자에게 말하듯이 대화하세요.
- 동사 + 범위로 시작:
Using the provided photo, change only the lighting./…add a few small props on the cloth."Change only"는 의미적 마스크 역할을 합니다. - 변경 사항을 물리적으로 설명하세요: 광원, 방향, 품질, 색상 (
color #FFE2B8, about 5000K, not orange), 그림자가 지는 방식. - 보존 목록으로 마무리하며 각 요소를 명명하세요: 모양, 소용돌이, 아이싱, 리본, 베이스, 주름, 프레이밍, 초점 및 입자가 있는 핸드폰 카메라 느낌. 이 마지막 부분이 없으면 사진을 "정리"하여 AI처럼 보이게 만듭니다.
- 2–6 문장. 주제에서 벗어나면 짧게 만드세요: 형용사 제거, 한 가지 변경.
make it feel like a little more sun came through, like a subtle color grade와 같은 한 줄짜리도 미묘한 변경에 효과적입니다. - 긍정적인 표현을 사용하고 "X 없음"은 피하세요:
empty corner of the cloth,no clutter대신. - 다중 참조: 각 이미지의 역할을 명시하세요 (
the first image is the product to keep, the second is the mood reference for the light). - 원본에서 반복하여 대안을 만들고, 누적 변경의 경우에만 마지막으로 좋았던 결과에서 반복하세요 (오류가 누적됨).
준비된 템플릿: references/templates.md.
FLUX.2 Max 프롬프팅 (BFL 가이드)
FLUX는 최종 이미지를 설명하며, 명령이 아닙니다.
- 주제 → 동작 → 스타일 → 맥락 순서; 첫 단어가 가장 중요합니다. 장면이 복잡하지 않은 경우 30–80 단어.
- 부정 프롬프트 없음. 모든 것을 긍정적으로:
sharp focus throughout,matte finish,soft-edged shadows. - 실제 카메라: 집에서 찍은 느낌을 위해
shot on iPhone 15, natural grain; 편집 스타일을 위해Fujifilm X-T5, 35mm f/1.4또는Kodak Portra 400. - Hex는 객체에 연결하고
color라는 단어를 사용하세요:the frosting is color #FFF8E7. 여러 색상 제품: 구성 요소당 하나의 주제 +color_match: "exact". - 편집:
The same photo of [product] from image 1, unchanged: [list]로 시작한 다음 새로운 조명을 추가하세요. - JSON은 프로덕션/다중 주제에 사용하고, 자연어는 탐색에 사용하세요. 한 번에 한 필드씩 반복하고, 동일한 시드를 사용하세요.
- 이미지 속 텍스트: 정확한 따옴표, 위치, 서체, 크기 및 색상을 지정하세요.
스키마 (--prompt-file로 직렬화됨; 예제는 examples/prompt-example.json 참조):
{
"scene": "...",
"subjects": [{"description": "...", "position": "...", "action": "...", "color_palette": ["#hex"], "color_match": "exact"}],
"style": "...", "color_palette": ["#hex"], "lighting": "...", "mood": "...",
"background": "...", "composition": "...",
"camera": {"angle": "...", "lens": "50mm f/2.2", "depth_of_field": "..."}
}
사실감 규칙 (두 모델 공통)
자세한 내용과 복사 가능한 블록: references/realism.md.
- 부드러운 확산광 > 강한 빛. 프레임을 가로지르는 강한 창틀 그림자는 AI임을 드러냅니다 (블라인드 테스트에서 거절 원인 1위).
soft, diffused, low-contrast shadows, muted highlights를 요청하세요. - 적당한 온도감: hex + 켈빈 값 +
not orange(Nano) /not neutral white(FLUX)를 추가하세요. ~5000K는 모든 것을 주황색으로 물들이지 않으면서 햇살 느낌을 줍니다. - 장면에 존재하는 하나의 광원이어야 합니다.
- 손은 없음; 제품은 표면에 놓여 있습니다.
- 원래 카메라 느낌 유지 (입자, 약간의 부드러움). 선명한 렌더링 = AI.
- 최소한의 실제 소품 (소나무 가지 하나, 계피 스틱 2개, 별모양 아니스 하나)을 빈 공간에 제품과 닿지 않게 배치하세요. 카탈로그 세트나 안개는 금지.
- 질감 있는 천 (
눈에 띄는 직조가 있는 무광 면) 사용, 그렇지 않으면 플라스틱 새틴처럼 나옵니다.
충실도와 개수 세기
- 참조가 있는 경우 사진의 각도, 카메라 높이 및 프레이밍을 유지하세요.
- 각 제품을 이름과 위치로 열거하세요. 개수로 마무리:
exactly six cupcakes, exactly four brownies. FLUX에서는:EXACTLY N distinct items total: [list]. - 비슷한 제품이 3개 이상이면 구분하지 않으면 합쳐집니다. 2회 시도 후에도 6개 이상 실패하면 각각 생성하고 다중 참조로 재구성하세요.
워크플로우
- 식별: 사진 유/무, 형식, 변경 사항 (조명 / 소품 / 배경).
- 각 사진 살펴보기 (읽기): 제품, 각도, 현재 조명, 정확한 요소.
- 프롬프트를 임시 파일에 작성하고 (Nano는
.txt, FLUX는.json)gen.py를 실행하세요. - 확인: 출력을 원본과 나란히 비교하여 두 가지 축에서 확인하세요:
- 사실감: 사진인가 렌더링인가? 플라스틱 같은가? 이상한 강한 그림자? 손, 떠 있는 물체, 변형된 세부 사항? 개수가 정확한가? 제품이 원본과 동일한가?
- 요구 사항: 요청한 조명/색상이 보이는가? 온도를 명시적으로 확인하세요.
- 실패 → 2차 시도: 프롬프트를 짧게 하고 한 가지를 변경하세요. 두 번째 실패 →
--no-upsample과 함께 FLUX.2 Max를 시도하세요. 최대 3회 시도; 그 후 최상의 결과를 전달하고 무엇이 실패했는지 알리세요. - 파일과 함께 변경 사항 및 비용을 한 줄로 전달하세요. 배치 종료 시: 총 비용과 잔액을 알리세요.
- 임시 프롬프트 파일을 삭제하세요.
프리셋
전체 조명 레시피는 references/light-presets.md에 있습니다.
| 프리셋 | 조명 / 스타일 | 용도 |
|---|---|---|
| Soft sun (편집 기본값) | 커튼을 통한 확산된 겨울 햇살, #FFE2B8 ~5000K | 집에서 만든/꿈꾸는 듯한 Pinterest 느낌 |
| Simple Christmas | 부드러운 햇살 + 2–4개의 자연 소품 + 먼 거리의 따뜻한 보케 | 계절감, 카탈로그 느낌 아님 |
| Real cozy | 부드러운 따뜻한 창문, 무광 린넨 | 브라우니, 케이크, 빵 |
| Clean studio | 3점 소프트박스, 심리스 | 카탈로그, 이커머스 |
| Real night | 따뜻한 램프 하나, 긁힌 나무, 고 ISO | 믿을 수 있는 어두운 분위기 |
| Golden hour | 낮은 태양 #FFC078, 긴 그림자 | 따뜻한 히어로 |
| Soft honey | 호박색 창문 #FFD9A0, ~4600K | 아늑함, 가장 균일함 |