SuperAPI AI Directory

commerce-product-image-pipeline

Design & creation

View repository

Updated 10-15 21:02

About this skill

Product Image/Video Full-Stack Pipeline (Product Image Pipeline)

Overview

A Korean e-commerce seller, with a single natural language line like "make me vegan serum images/videos," a 4-step chain from character consistency to per-channel packagingis an orchestrator skill that automatically invokes.

Responsibility in one line: Product info + category + channel input → character registration (optional) → media-higgsfield-image → media-higgsfield-video → channel spec conversion 4-step chain auto-execution → return full set of deliverables per channel.

vs commerce-detail-page-image: The paired skill produces one 13-section composite PNG. This skill produces 5-10 product images + 5-10 second video + per-channel conversion full set.

vs. calling media-higgsfield-video standalone: media-higgsfield-video generates a single video. This skill performs full-stack chain from images to video orchestration.

4-step pipeline

[Step 1] 캐릭터 등록 (선택, 권장 — Higgsfield Soul Characters)
   └─ 브랜드 마스코트 또는 모델 캐릭터 등록·재사용
   └─ 다음 단계에 character_id 전달 (일관성 확보)
   ↓
[Step 2] media-higgsfield-image (Soul 모델)
   └─ 상품 이미지 5-10장 생성
   └─ Hero(1) · Lifestyle(2) · Detail(2) · Use-case(2) · Result(1-2) 5축
   ↓
[Step 3] media-higgsfield-video (DOP 모델)
   └─ 시네마틱 영상 5-10초 (이미지 → 영상 변환)
   └─ orbit / pan_left / slow_zoom 모션 프리셋 적용
   └─ character_id 전달 (Step 1 사용 시)
   ↓
[Step 4] 채널 규격 변환 (Pillow 자체 처리)
   └─ 메타 (피드·릴스·스토리) / 네이버 GFA / 카카오 (친구톡·BizBoard)
   └─ 각 채널 규격 자동 변환 (해상도·길이·자막)
   └─ AI 생성 표기 자동 부착

Input slots

Item Required Example
Product info Required "Vegan serum 50ml, direct trade from Korean farms, 30-day refund"
Category Required Skincare, food, fashion, pets, home appliances, etc.
Use character Optional 사용 (character_id 필요) / 미사용 (제품 단독)
Channels (1-3) Required Meta, Naver GFA, Kakao Friend Talk, Kakao BizBoard, Coupang
Tone/mood Recommended Minimal, warm, premium, lively, etc.
Video length Recommended 5초 (Instagram Story) / 10초 (Reel) / 15초 (TVC)

Output scenarios

Scenario A: New D2C brand (no character)

[Step 1] 캐릭터 등록 skip
[Step 2] media-higgsfield-image:
   - Hero: 제품 단독 미니멀 샷 (1024×1024)
   - Lifestyle 2: 실제 사용 장면 (모델 손·테이블)
   - Detail 2: 매크로 클로즈업 (텍스처·라벨)
   - Use-case 2: 사용 순간 (얼굴·바를 때)
   - Result 1-2: 사용 후 결과 (Before/After 아닌 lifestyle)
[Step 3] media-higgsfield-video:
   - Hero 이미지를 orbit 5초 시네마틱
   - 또는 lifestyle 이미지를 slow_zoom 10초
[Step 4] 채널 규격 변환:
   - 메타 피드 1:1 / 메타 릴스 9:16 / 카카오 BizBoard 16:9

Scenario B: Has a brand mascot

[Step 1] 캐릭터 등록 (Higgsfield Soul Characters):
   - 브랜드 마스코트 등록 (또는 기존 character_id 사용)
   - 다음 단계에 character_id 전달
[Step 2] media-higgsfield-image with character_id:
   - 마스코트가 제품을 소개하는 이미지 (3D 캐릭터 + 제품)
   - 일관된 외형·복장·배경 유지
[Step 3] media-higgsfield-video with character_id:
   - 마스코트 + 제품 등장 영상 (5-10초)
[Step 4] 채널 변환

Scenario C: Model character (virtual influencer)

[Step 1] 캐릭터 등록 (Higgsfield Soul Characters):
   - 20대 후반 한국인 모델 캐릭터 등록
[Step 2] media-higgsfield-image with character_id:
   - 모델이 제품 사용하는 이미지 5장
[Step 3] media-higgsfield-video with character_id:
   - 모델 토킹 헤드 (Kling Avatars 등 아바타 프리셋 활용)
   - 또는 모델 사용 장면 시네마틱
[Step 4] 채널 변환

Output format

{
  "product": "비건 세럼 50ml",
  "category": "스킨케어",
  "character_used": true,
  "character_id": "characters/abc123",
  "pipeline_outputs": {
    "step_1_character": {
      "skip": false,
      "character_id": "characters/abc123",
      "type": "브랜드 마스코트 (Nova the Fox)"
    },
    "step_2_images": {
      "model": "Higgsfield Soul",
      "count": 7,
      "images": [
        {"type": "Hero", "url": "...", "aspect_ratio": "1:1"},
        {"type": "Lifestyle-1", "url": "...", "aspect_ratio": "1:1"},
        {"type": "Lifestyle-2", "url": "...", "aspect_ratio": "1:1"},
        {"type": "Detail-1", "url": "...", "aspect_ratio": "1:1"},
        {"type": "Detail-2", "url": "...", "aspect_ratio": "1:1"},
        {"type": "Use-case", "url": "...", "aspect_ratio": "1:1"},
        {"type": "Result", "url": "...", "aspect_ratio": "1:1"}
      ]
    },
    "step_3_video": {
      "model": "Higgsfield DOP",
      "source_image": "Hero",
      "duration": 8,
      "motion_preset": "orbit",
      "url": "...",
      "character_id": "characters/abc123"
    },
    "step_4_channels": {
      "meta_feed": {"format": "1:1 1080×1080", "url": "..."},
      "meta_reel": {"format": "9:16 1080×1920", "url": "..."},
      "kakao_bizboard": {"format": "16:9 1280×720", "url": "..."}
    },
    "ai_disclosure": "AI 생성 표기 자동 부착 완료"
  },
  "total_assets": "이미지 7장 + 영상 1편 + 채널 변환 3개"
}

Usage example

"/commerce-product-image-pipeline — 비건 세럼 50ml, 한국 농가 직거래, 스킨케어, 캐릭터 미사용, 메타 피드·릴스"
→ 4단계 자동 실행 → 이미지 7장 + 영상 1편 + 메타 피드·릴스 변환

"/commerce-product-image-pipeline — 반려견 간식, 마스코트 'Nova the Fox' 사용, 네이버 GFA 우선"
→ 캐릭터 등록 → 마스코트 + 제품 이미지·영상 → 네이버 GFA 변환

"/commerce-product-image-pipeline — 비건 세럼, 20대 한국 모델 사용, 토킹 헤드 포함, 메타 릴스"
→ 캐릭터 등록 → media-higgsfield-image + media-higgsfield-video (토킹 헤드 포함) → 릴스 변환

Quality checklist

  • All 4 chain steps executed (Step 1 optionally skipped)
  • 5-10 images (5 axes: Hero, Lifestyle, Detail, Use-case, Result)
  • 5-10 second video (cinematic motion preset)
  • Per-channel conversion complete (selected 1-3 channels)
  • AI-generated label automatically attached
  • Consistency verification when using character_id (optional)

Cost estimate

Scenario Step Estimated cost
7 images only media-higgsfield-image (Soul) ₩2,000-3,500
+ 1 video (8 seconds) media-higgsfield-video (DOP) + ₩300-500
+ 3 channel conversions Channel spec conversion + ₩0 (Pillow handled natively)
+ Character registration (first time only) Soul Characters + ₩0 (account plan)
총 Full set ₩2,300-4,000 / per product

Costs are based on Higgsfield pay-as-you-go. Check the official site for actual pricing (higgsfield.ai).

Workflow

Step 1: Decide whether to use a character

[Q1] 브랜드 마스코트 또는 모델 캐릭터를 이미 사용 중인가?
   ├─ 예 → 기존 character_id 입력 → Step 2 직진
   └─ 아니오 → [Q2]

[Q2] 일관된 캐릭터·모델로 시리즈 콘텐츠 만들 계획인가?
   ├─ 예 → Higgsfield Soul Characters로 신규 캐릭터 등록 (10-15분)
   └─ 아니오 → 제품 단독 이미지 모드 (Step 1 skip)

Step 2-4: Automatic execution

  • Automatically distributes 5 image axes (Hero·Lifestyle·Detail·Use-case·Result) according to category
  • Video motion presets are automatically selected according to category and tone (skincare=slow_zoom / fashion=pan_left / food=orbit)
  • Channel conversion automatically applies each channel's official specifications

Related skills

Chaining (this skill orchestrates):

  • Higgsfield Soul Characters character registration — Step 1 (optional, moai-media:media-higgsfield-image character consistency feature)
  • moai-media:media-higgsfield-image — Step 2 (Soul)
  • moai-media:media-higgsfield-video — Step 3 (DOP)
  • Channel specification conversion + AI-generated labeling — Step 4 (handled by Pillow itself)

Linked (user calls separately):

  • commerce-detail-page-image — 13-section composite PNG (paired, different responsibility)
  • commerce-detail-page-copy — detail page copy (separate from images and videos)
  • commerce-product-naming — product name (used in image captions)

When not to use this skill

  • 1 13-section composite PNG: commerce-detail-page-image use
  • Single image generation: moai-media:media-higgsfield-image direct call
  • Single video generation: moai-media:media-higgsfield-video direct call
  • Ad video category routing: Higgsfield MCP(DOP) direct call

References

  • Korean D2C e-commerce standard 5 image axes (Hero·Lifestyle·Detail·Use-case·Result)