Community이미지github.com

Fishkiller111/ai-ecommerce-product-images

실제 제품 원본 사진으로 흰 배경 컷아웃과 전자상거래 상품 메인 이미지를 제작합니다. 제품의 정체성, 포장 텍스트, 색상, 구조 및 비율을 엄격히 고정하며, APIMart의 gpt-image-2.6-flare-ext를 통해 이미지를 편집 및 생성합니다. 사용자가 제품 사진, 컷아웃, 흰 배경 이미지, 전자상거래 이미지 또는 상품 메인 이미지가 필요할 때 사용합니다.

ai-ecommerce-product-images란 무엇인가요?

이 스킬은 실제 제품 사진을 전문적인 전자상거래용 이미지로 변환하는 AI 에이전트용 기술입니다. 두 가지 최종 결과물을 생성합니다: 첫째, 원본 제품의 모든 외관과 포장 정보(로고, 텍스트, 라벨, 색상, 비율, 구조)를 완벽하게 보존한 흰 배경 컷아웃 이미지; 둘째, 이 흰 배경 이미지를 유일한 사실 기준으로 삼아 깔끔하고 신뢰할 수 있는 전자상거래 시나리오 이미지입니다. 스킬은 제품 재디자인을 금지하며, 포장 텍스트나 브랜드를 변경하지 않고, 스타일 참조 이미지를 제품 사실로 오인하지 않도록 엄격한 검증 절차를 포함합니다. APIMart의 gpt-image-2.6-flare-ext 모델을 사용하며, API 키와 임시 URL의 안전한 처리를 보장합니다. Cursor, Claude Code, Codex 등 다양한 AI 에이전트 플랫폼과 호환되며, APIMART_API_KEY 환경 변수와 APIMART_BASE_URL 설정이 필요합니다. 사용자가 제품 사진, 흰 배경 이미지, 전자상거래 이미지 또는 상품 메인 이미지를 요청할 때 자동으로 실행되도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Fishkiller111/ecommerce-product-image-skills/tree/HEAD/skills/ai-ecommerce-product-images

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

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

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

문서

전자상거래 상품 이미지 제작

목표

실제 제품 사진 한 장을 다음 두 가지로 빠르게 처리합니다:

  1. 흰 배경 보존 이미지: 원본 배경을 제거하고 제품을 순백색 배경에 배치하며, 원본 제품의 모든 외관과 포장 정보를 보존합니다.
  2. 실감형 전자상거래 메인 이미지: 흰 배경 보존 이미지를 유일한 제품 사실 기준으로 삼아 깔끔하고 신뢰할 수 있으며 전자상거래 전시에 적합한 장면 이미지를 생성합니다.

기본적으로 필요한 조명, 구도 및 배경 처리만 수행하며, 제품을 재디자인하지 않습니다.

입력

  • SOURCE_IMAGE: 고객이 제공한 실제 제품 원본 사진. 필수 항목입니다.
  • STYLE_REFERENCE: 선택적 전자상거래 구도 참조 이미지. 배치, 조명, 여백 및 정보 계층만 참조하며, 제품, 텍스트, 가격, 인증 또는 광고 문구를 복사하지 않습니다.
  • OUTPUT_DIR: 출력 디렉터리. 기본값은 ./outputs/product-images/입니다.

여러 이미지를 받으면 어느 것이 제품 사실 이미지이고 어느 것이 스타일 참조 이미지인지 먼저 판단합니다. 스타일 참조 이미지의 제품 세부 정보를 원본 제품에 덮어쓰지 않습니다.

고정 절차

1. APIMart 규칙 읽기

현재 환경에서 사용 가능한 APIMart 도구를 사용하거나, APIMart 공식 인터페이스 문서의 업로드, 인증 및 비동기 폴링 방식을 따라 호출합니다. API 키는 APIMART_API_KEY 등 사용자가 구성한 환경 변수 또는 안전한 자격 증명 관리자에서 읽으며, 서비스 주소는 APIMART_BASE_URL 또는 서비스 제공업체의 공식 구성을 사용합니다. 키, 사용자 파일 또는 임시 URL을 스킬 파일, 스크립트, 로그 또는 전달 문서에 기록하지 않습니다. 자격 증명이나 서비스 주소가 구성되지 않은 경우 구성이 필요함을 설명하고, 다른 사용자의 키를 도용하거나 검색하지 않습니다. API는 요금이 부과될 수 있습니다. 사용자가 원본 이미지 처리를 위해 APIMart 사용을 지정하거나 동의한 경우, 작업을 실행하고 비용을 안내합니다. 해당 권한이 없거나 사용자가 업로드를 거부하거나 서비스가 구성되지 않은 경우 먼저 설명합니다.

주 모델은 gpt-image-2.6-flare-ext로 고정됩니다. 인터페이스에서 명시적으로 '모델이 존재하지 않음'을 반환하는 경우에만 APIMart에서 사용 가능한 GPT Image 확장 모델을 사용하고, 결과에 롤백이 발생했음을 명시합니다. 모델을 조용히 변경하지 않습니다.

2. 원본 이미지 업로드

APIMart 이미지 업로드 인터페이스를 사용하여 SOURCE_IMAGE를 업로드하고 source_url을 얻습니다. STYLE_REFERENCE가 있는 경우 별도로 업로드하여 style_url을 얻습니다. 업로드가 완료되면 즉시 작업 기록을 저장하고, 임시 URL을 고객 전달 문서에 기록하지 않습니다.

3. 흰 배경 보존 이미지 생성

APIMart 이미지 생성/편집 인터페이스를 호출하고 source_url을 유일한 제품 참조로 사용합니다. 프롬프트는 아래 템플릿을 직접 사용하고 대괄호 안의 내용을 적절히 채웁니다:

Edit the provided product photo into a clean e-commerce white-background product cutout.
The product identity is locked to the source image.
Preserve exactly: package shape, front and side panels, dimensions, proportions, colors,
logos, labels, Chinese text, English text, dosage/volume markings, seals, caps, edges,
folds and all visible printed details.
Remove only the original environment and background. Use a pure white background,
soft natural contact shadow, centered product, full product visible, realistic camera
perspective, accurate geometry, high-detail commercial photography.
Do not redesign, beautify into another product, rewrite text, translate text, add text,
remove text, change the package, change the brand, change the logo, change the color,
add props, add people, add medical claims, add badges, add price tags or add decorative
copy. If any printed text is uncertain, preserve the original appearance rather than
inventing a replacement.

출력 파일명: 01_white_bg_preserved.png.

4. 보존 확인

전자상거래 이미지 생성 전에 흰 배경 이미지를 반드시 검사합니다:

  • 포장의 앞면, 측면, 상단 및 모서리가 원본 이미지와 일치하는가?
  • 제품 수량, 크기 비율, 색상, 원근감 및 구조가 변경되었는가?
  • 브랜드, 상표, 승인 번호, 규격, 중국어 및 영어 텍스트가 다시 작성되거나 깨졌는가?
  • 추가 병, 상자, 식물, 약, 사람, 가격, 인증, 효능 단어 또는 장식이 나타났는가?
  • 배경이 흰색이고 제품이 완전하며, 컷아웃에 거친 가장자리나 투과가 없는가?

어느 하나라도 실패하면 완제품으로 전달하지 않습니다. 동일한 원본 이미지로 'identity locked / preserve exact packaging / no new text'를 강화하여 최대 한 번 더 시도합니다. 그래도 통과하지 못하면 명확히 REJECTED로 표시하고, 완료된 척하거나 무한 재시도하지 않습니다.

5. 실감형 전자상거래 메인 이미지 생성

01_white_bg_preserved.png를 제품 사실 이미지로 사용하고, STYLE_REFERENCE는 구도 참조로만 사용합니다. 프롬프트는 다음과 같습니다:

Create one realistic e-commerce product hero image using the provided preserved product cutout.
The supplied cutout is the exact product truth and must remain unchanged.
Keep the same package shape, logo, brand, printed text, colors, proportions, side panel,
volume markings and all visible details. Do not redraw or reinterpret the product.
Build a clean, credible commercial composition with [SCENE], [LIGHTING], [CAMERA_ANGLE]
and generous negative space. Use premium but restrained styling, realistic shadows and
accurate materials. No people, no hands, no extra products, no medical advice, no efficacy
claims, no price, no platform badge, no invented slogan, no invented certification, no
new package text and no visual element that could be mistaken as part of the product.
The final image must look like a real product photograph, not an illustration or a fantasy ad.

기본 매개변수:

  • SCENE: 간결하고 사실적이며 상품 카테고리와 관련된 전자상거래 장면.
  • LIGHTING: 부드러운 자연광. 과도한 스무딩, 과다 노출 및 플라스틱 느낌을 피합니다.
  • CAMERA_ANGLE: 약간의 3/4 각도로, 전면과 필요한 측면이 읽힐 수 있도록 합니다.
  • 화면 비율은 우선 1:1; 상세 페이지 가로 이미지의 경우 4:5 또는 3:4 사용 가능.
  • 기본 resolution: 2k; 고객이 명시적으로 요청하는 경우에만 더 높은 해상도를 사용합니다.

출력 파일명: 02_ecommerce_hero.png.

6. 전자상거래 이미지 확인

확인할 사항: 제품이 여전히 원본 제품인가; 포장 텍스트가 변경되지 않았는가; 장면이 효능 암시를 만들지 않는가; 가격, 플랫폼 각인, 가짜 인증 또는 과장 광고가 없는가; 구도가 전자상거래 썸네일과 상세 페이지에 적합한가; 명백한 AI 생성 흔적이 없는가.

출력 계약

다음만 전달합니다:

OUTPUT_DIR/
├── 01_white_bg_preserved.png
└── 02_ecommerce_hero.png

어느 단계에서든 실패하면 실패 이유, 실패 이미지 경로 및 다음 수정 단계를 출력하고, 불합격 이미지를 전달하지 않습니다.

결과 설명은 다음 세 줄만 유지합니다:

원본 이미지: <파일명>
결과: 흰 배경 보존 이미지 <경로>; 전자상거래 메인 이미지 <경로>
검사: 제품 정체성/포장 텍스트/구조 비율 확인 완료; <통과 또는 재작업 필요 이유>

금지 사항

  • 원본 제품을 다른 제품으로 미화하지 않습니다.
  • 포장 텍스트, 브랜드, 상표, 승인 번호, 규격 및 가격을 임의로 수정하거나 보충하지 않습니다.
  • 스타일 참조 이미지를 제품 사실 이미지로 오인하지 않습니다.
  • 의약품, 건강기능식품 또는 의료 관련 제품에 효능, 치유, 절대적 표현 또는 제공되지 않은 홍보 문구를 추가하지 않습니다.
  • APIMart API 키를 유출하지 않으며, 키를 스킬, 로그, 이미지 메타데이터 또는 고객 문서에 기록하지 않습니다.
  • 보존 확인을 우회하지 않습니다. 흰 배경 이미지가 통과하지 못하면 전자상거래 이미지를 생성하지 않습니다.

관련 스킬