liangdabiao/ecom-details-image
一个面向workbuddy / Codex 等agent 的跨境电商和国内电商通用视觉创作 Skill。我精选25个高质量案例，涵盖纯色底产品主图、场景化生活图、平铺图、电商详情图、真实场景等等，全部配完整提示词，都可以利用 GPT-Image-2 API生成最终效果。一键生成电商相关图片！输入产品图片和需求描述，自动生成完整的电商主图、详情页图片、社媒推广图、直播间场景图等全套视觉素材。 与众不同之处是：**Campaign Style Lock** 机制 和 **强推广** 和 **重视转化效果**。
ecom‑details‑image 스킬
개요 – 전자상거래 제품 페이지에 필요한 전체 비주얼 에셋(메인 제품 사진, 상세 페이지 이미지, 소셜 미디어 배너, 라이브 스트리밍 배경 등)을 생성하는 데 도움을 주는 명령줄 기반 '스킬'입니다. Claude Code, Codex 또는 WorkBuddy 환경에서 작동하며 apiz 이미지 생성 서비스(또는 Codex 내장 imagegen 도구)와 통신합니다. 이 스킬은 다음을 수행할 수 있습니다:
- 비주얼 브리프와 즉시 사용 가능한 프롬프트를 생성하여 이미지 모델에 전달하거나,
- 이미지 모델을 직접 호출하여 생성된 이미지를 저장합니다.
주요 개념
| 개념 | 의미 |
|---|---|
| 프롬프트 / 브리프 모드 | 스킬은 구조화된 브리프(목표, 스타일, 전환 동인 등)와 최종 프롬프트 및 부정적 제약 조건을 반환합니다. apiz CLI가 설치되어 있지 않으면 이미지가 생성되지 않습니다. |
| 생성 모드 | '이미지 렌더링'을 요청하면 스킬이 최종 프롬프트를 구축하고, Campaign Style Lock(색상, 조명, 글꼴, 레이아웃 등을 세트 전체에서 일관되게 유지하기 위한 텍스트 블록)을 생성한 다음, Codex imagegen 도구를 호출하거나 apiz CLI를 사용하는 scripts/generate_image.py를 실행합니다. |
| Campaign Style Lock | 모든 이미지 프롬프트에 주입되는 재사용 가능한 스타일 설명으로, 번들 전체가 조화롭게 보이도록 합니다. |
| apiz CLI | 참조 이미지를 업로드하고, AI 이미지 모델(기본값 apiz/gpt-image-2.5-flare)에 생성 요청을 제출하며, 작업 완료를 기다리고 결과를 다운로드하는 타사 명령줄 클라이언트입니다. |
| 이미지 팩 규칙 | 기본적으로 이 스킬은 완전한 전자상거래 패키지(메인 제품 사진 5장과 상세 페이지 이미지 7~9장, 각 이미지별 프롬프트 파일 포함)를 출력합니다. |
사용 방법
- apiz CLI 설치 (자동 이미지 생성을 원하는 경우):
apiz --version # 설치 확인 apiz auth login # API 키 저장 - 저장소 복제 후 루트 디렉토리로 이동합니다.
- 스킬 실행 (AI 어시스턴트 환경을 통해) 후 브리프 또는 전체 이미지 팩을 요청합니다. 어시스턴트에 입력할 수 있는 프롬프트 예시: “Generate a visual brief and prompt for a premium‑look Amazon main image of a self‑heating eye mask.” “Render the full image pack for a laundry pod product, using the configured API.”
- 생성을 요청한 경우, 스킬은 다음을 수행합니다:
- 최종 프롬프트 구축.
- Campaign Style Lock 생성.
imagegen(Codex) 호출 또는python3 scripts/generate_image.py …(apiz) 실행.- 이미지를
generated-images/(또는 지정한 폴더)에 저장하고 파일 경로 반환.
명령줄 도우미 (scripts/generate_image.py)
| 옵션 | 설명 |
|---|---|
--prompt "…" |
명령줄에서 직접 프롬프트 문자열 입력. |
--prompt-file FILE |
텍스트 파일에서 프롬프트 읽기. |
--output-dir DIR |
생성된 이미지를 저장할 위치 (기본값 generated-images/). |
--size RATIO |
가로세로 비율 (1:1, 4:5, 16:9 등) – 1024x1024와 같은 픽셀 형식도 허용. |
--model MODEL_ID |
사용할 이미지 모델 (기본값 apiz/gpt-image-2.5-flare). |
--image PATH |
로컬 참조 제품 사진 – apiz CDN에 먼저 업로드됩니다. |
--image-url URL |
참조 이미지의 공개 URL (--image보다 우선함). |
--timeout SEC |
apiz 작업 대기 최대 시간 (기본값 420). |
--format EXT |
저장할 이미지 확장자 (기본값 png). |
--env-file FILE |
사용자 지정 .env 파일에서 환경 변수 로드. |
일반적인 호출:
python3 scripts/generate_image.py \
--prompt-file prompt.txt \
--size 4:5 \
--model apiz/gpt-image-2.5-flare \
--image data/product.jpg \
--output-dir outputs
제한 사항 및 안전 주의 사항
- 비용 – 각 이미지는 apiz 크레딧을 소모합니다(이미지당 약 30~90초). 대량 작업 전
apiz account balance로 잔액을 확인하세요. - 비동기 생성 – CLI는 작업 완료를 기다리지만(
--wait), 기본 URL은 일시적입니다. 스크립트는 파일을 로컬로 다운로드합니다. - 비밀 정보 유출 방지 – 저장소는 API 키를 절대 저장하지 않습니다. apiz CLI 로그인 또는 환경 변수를 통해 제공해야 합니다.
- 콘텐츠 정책 – 스킬은 부정적 제약 조건(예: '읽을 수 있는 텍스트 없음')을 추가하며, 비주얼 카피 내에서 인증이나 테스트 결과를 조작하지 말 것을 경고합니다.
- 모델별 해상도 – 출력 픽셀 크기는 선택한 모델에 따라 다릅니다(기본값은 최대 4K 지원).
활용 대상
- 전자상거래 판매자: Amazon, Shopify, TikTok Shop 등을 위해 일관된 제품 이미지 세트를 빠르게 제작해야 하는 경우.
- 마케팅 팀: AI로 생성된 광고 배너, 소셜 미디어 그래픽 또는 라이브 스트리밍 배경이 필요한 경우.
- AI 어시스턴트 봇 개발자: 자체 통합 코드를 작성하지 않고 즉시 사용 가능한 이미지 생성 스킬을 내장하고 싶은 경우.
빠른 시작 체크리스트
apizCLI를 설치하고 로그인합니다.- 저장소를 복제합니다.
- AI 어시스턴트에서 브리프 또는 전체 이미지 팩을 요청합니다.
- 생성을 요청했다면
generated-images/에서 파일을 확인합니다. - 비주얼 브리프를 검토하고, 필요시 프롬프트를 조정하며, 생성된 에셋으로 A/B 테스트를 수행합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트