Community이미지github.com

제품 사진

합성처럼 보이지 않는 제품, 음식, 장면 사진을 고치거나 만든다. 참고 사진이 있으면 그것을 쓰고, 재조명인지 새 그림인지에 따라 모델을 고른다.

제품 사진란 무엇인가요?

제품 사진은 모든 정지 이미지를 하나의 생성 스크립트로 보낸다. 실제 사진이 있으면 조명이나 배치를 고치고, 원본이 없을 때만 새로 만든다. 정사각, 스토리, 세로형을 카탈로그와 소셜 게시용으로 낸다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umi008/product-photo-ai/tree/HEAD/plugins/product-photo-ai/skills/product-photo-ai

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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: vertical 9:16 (기본값) · insta 4:5 · portrait 3:4 · tall 2:3 · square 1:1 · classic 4:3 · landscape 16:9 · wide 21: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이 아닌 산문 형식으로 사진 편집자에게 말하듯이 대화하세요.

  1. 동사 + 범위로 시작: Using the provided photo, change only the lighting. / …add a few small props on the cloth. "Change only"는 의미적 마스크 역할을 합니다.
  2. 변경 사항을 물리적으로 설명하세요: 광원, 방향, 품질, 색상 (color #FFE2B8, about 5000K, not orange), 그림자가 지는 방식.
  3. 보존 목록으로 마무리하며 각 요소를 명명하세요: 모양, 소용돌이, 아이싱, 리본, 베이스, 주름, 프레이밍, 초점 및 입자가 있는 핸드폰 카메라 느낌. 이 마지막 부분이 없으면 사진을 "정리"하여 AI처럼 보이게 만듭니다.
  4. 2–6 문장. 주제에서 벗어나면 짧게 만드세요: 형용사 제거, 한 가지 변경. make it feel like a little more sun came through, like a subtle color grade와 같은 한 줄짜리도 미묘한 변경에 효과적입니다.
  5. 긍정적인 표현을 사용하고 "X 없음"은 피하세요: empty corner of the cloth, no clutter 대신.
  6. 다중 참조: 각 이미지의 역할을 명시하세요 (the first image is the product to keep, the second is the mood reference for the light).
  7. 원본에서 반복하여 대안을 만들고, 누적 변경의 경우에만 마지막으로 좋았던 결과에서 반복하세요 (오류가 누적됨).

준비된 템플릿: references/templates.md.

FLUX.2 Max 프롬프팅 (BFL 가이드)

FLUX는 최종 이미지를 설명하며, 명령이 아닙니다.

  1. 주제 → 동작 → 스타일 → 맥락 순서; 첫 단어가 가장 중요합니다. 장면이 복잡하지 않은 경우 30–80 단어.
  2. 부정 프롬프트 없음. 모든 것을 긍정적으로: sharp focus throughout, matte finish, soft-edged shadows.
  3. 실제 카메라: 집에서 찍은 느낌을 위해 shot on iPhone 15, natural grain; 편집 스타일을 위해 Fujifilm X-T5, 35mm f/1.4 또는 Kodak Portra 400.
  4. Hex는 객체에 연결하고 color라는 단어를 사용하세요: the frosting is color #FFF8E7. 여러 색상 제품: 구성 요소당 하나의 주제 + color_match: "exact".
  5. 편집: The same photo of [product] from image 1, unchanged: [list]로 시작한 다음 새로운 조명을 추가하세요.
  6. JSON은 프로덕션/다중 주제에 사용하고, 자연어는 탐색에 사용하세요. 한 번에 한 필드씩 반복하고, 동일한 시드를 사용하세요.
  7. 이미지 속 텍스트: 정확한 따옴표, 위치, 서체, 크기 및 색상을 지정하세요.

스키마 (--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개 이상 실패하면 각각 생성하고 다중 참조로 재구성하세요.

워크플로우

  1. 식별: 사진 유/무, 형식, 변경 사항 (조명 / 소품 / 배경).
  2. 각 사진 살펴보기 (읽기): 제품, 각도, 현재 조명, 정확한 요소.
  3. 프롬프트를 임시 파일에 작성하고 (Nano는 .txt, FLUX는 .json) gen.py를 실행하세요.
  4. 확인: 출력을 원본과 나란히 비교하여 두 가지 축에서 확인하세요:
    • 사실감: 사진인가 렌더링인가? 플라스틱 같은가? 이상한 강한 그림자? 손, 떠 있는 물체, 변형된 세부 사항? 개수가 정확한가? 제품이 원본과 동일한가?
    • 요구 사항: 요청한 조명/색상이 보이는가? 온도를 명시적으로 확인하세요.
  5. 실패 → 2차 시도: 프롬프트를 짧게 하고 한 가지를 변경하세요. 두 번째 실패 → --no-upsample과 함께 FLUX.2 Max를 시도하세요. 최대 3회 시도; 그 후 최상의 결과를 전달하고 무엇이 실패했는지 알리세요.
  6. 파일과 함께 변경 사항 및 비용을 한 줄로 전달하세요. 배치 종료 시: 총 비용과 잔액을 알리세요.
  7. 임시 프롬프트 파일을 삭제하세요.

프리셋

전체 조명 레시피는 references/light-presets.md에 있습니다.

프리셋조명 / 스타일용도
Soft sun (편집 기본값)커튼을 통한 확산된 겨울 햇살, #FFE2B8 ~5000K집에서 만든/꿈꾸는 듯한 Pinterest 느낌
Simple Christmas부드러운 햇살 + 2–4개의 자연 소품 + 먼 거리의 따뜻한 보케계절감, 카탈로그 느낌 아님
Real cozy부드러운 따뜻한 창문, 무광 린넨브라우니, 케이크, 빵
Clean studio3점 소프트박스, 심리스카탈로그, 이커머스
Real night따뜻한 램프 하나, 긁힌 나무, 고 ISO믿을 수 있는 어두운 분위기
Golden hour낮은 태양 #FFC078, 긴 그림자따뜻한 히어로
Soft honey호박색 창문 #FFD9A0, ~4600K아늑함, 가장 균일함

관련 스킬