morpheus-fashion-design

利用人工智能模型手持/佩戴产品生成专业的广告图像。 ✅ 使用时间： - 需要图像中包含产品的人物/模特 - 制作时尚广告、产品活动、商业摄影 - 希望多次拍摄时模特脸部保持一致 - 需要专业灯光/摄像机模拟 - 输入：产品图片+型号参考（或目录） ❌ 不要在以下情况下使用： - 只需编辑/修改现有图像 → 使用 nano-banana-pro - 仅产品无人拍摄→使用nano-banana-pro - 已经有英雄图像，需要变化 → 使用 multishot-ugc - 需要视频，而不是图像→生成图像后使用 veed-ugc - 基于 URL 的产品获取和品牌简介 → 使用广告就绪替代 输出：单个高质量 PNG 图像（2K-4K 分辨率）

## 概述（中文）

利用人工智能模型手持/佩戴产品生成专业的广告图像。
✅ 使用时间：
- 需要图像中包含产品的人物/模特
- 制作时尚广告、产品活动、商业摄影
- 希望多次拍摄时模特脸部保持一致
- 需要专业灯光/摄像机模拟
- 输入：产品图片+型号参考（或目录）
❌ 不要在以下情况下使用：
- 只需编辑/修改现有图像 → 使用 nano-banana-pro
- 仅产品无人拍摄→使用nano-banana-pro
- 已经有英雄图像，需要变化 → 使用 multishot-ugc
- 需要视频，而不是图像→生成图像后使用 veed-ugc
- 基于 URL 的产品获取和品牌简介 → 使用广告就绪替代
输出：单个高质量 PNG 图像（2K-4K 分辨率）

## 原文

# Morpheus Fashion Design

Generate professional fashion/product advertising images using ComfyDeploy's Morpheus Fashion Design workflow.

## ⚠️ CRITICAL RULES

### 1. NO `logo` field — EVER
The `logo` input has been **removed from the API**. Do NOT pass it.
Only two image inputs exist:
- `product` → the product being advertised
- `model` → frontal face photo of the model

### 2. NEVER USE AUTO VALUES for packs
**Configuration packs MUST NEVER be left on `auto` or `AUTO`.**

`auto` = empty values = neutral, boring images with no creative direction.

Always select deliberately based on the brief. Custom string values are allowed and encouraged.

## Pack Selection Guidelines

| Pack | How to Choose |
|------|---------------|
| `style_pack` | Brand personality: luxury→`premium_restraint`, sports→`cinematic_realism`, street→`street_authentic` |
| `camera_pack` | Sports→`sony_a1`, editorial→`hasselblad_x2d`, street→`leica_m6` |
| `lens_pack` | Portrait compression? Wide? Match shot type and mood |
| `lighting_pack` | Golden hour? Studio? Natural window? Match brief |
| `pose_discipline_pack` | Sport action→`sport_in_motion`, commercial→`commercial_front_facing`, UGC→`street_style_candid_walk` |
| `film_texture_pack` | Warm editorial→`kodak_portra_400`, cinematic→`kodak_vision3_500t`, clean→`digital_clean_no_emulation` |
| `environment_pack` | `beach_minimal`, `urban_glass_steel`, `street_crosswalk` — or custom string |
| `color_science_pack` | `warm_golden_editorial`, `neutral_premium_clean`, `cinematic_low_contrast` |
| `time_weather_pack` | `golden_hour_clear`, `bright_midday_sun`, `overcast_winter_daylight` |

## API Details

**Endpoint:** `https://api.comfydeploy.com/api/run/deployment/queue`
**Deployment ID:** `1e16994d-da67-4f30-9ade-250f964b2abc`

## Canonical API Call

```javascript
const response = await fetch("https://api.comfydeploy.com/api/run/deployment/queue", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    "deployment_id": "1e16994d-da67-4f30-9ade-250f964b2abc",
    "inputs": {
      "product": "/* product image URL */",
      "model":   "/* model face URL */",
      "brief":   "Detailed scene, pose, lighting, mood, product placement...",
      "target":  "Target audience: demographics, psychographics, lifestyle...",
      "input_seed": -1,
      "branding_pack": "logo_none",
      "aspect_ratio": "9:16",
      "style_pack": "street_authentic",
      "camera_pack": "sony_a1",
      "lens_pack": "zeiss_otus_55",
      "film_texture_pack": "kodak_portra_400",
      "color_science_pack": "warm_golden_editorial",
      "shot_pack": "medium_shot",
      "pose_discipline_pack": "street_style_candid_walk",
      "lighting_pack": "natural_window",
      "time_weather_pack": "golden_hour_clear",
      "environment_pack": "urban_glass_steel",
      "intent": "awareness"
    }
  })
});
```

## 🎭 Model Catalog

**GitHub:** `https://github.com/PauldeLavallaz/model_management`
**Local path:** `~/clawd/models-catalog/catalog/images/`

### Priority order
1. User provides model image → use directly
2. User describes model → search catalog, select best match
3. No specification → choose based on brief context

### Searching
```bash
# By body type
cat models-catalog/catalog/catalog.json | python3 -c "
import json,sys; data=json.load(sys.stdin)
for t in data['talents']:
    if t.get('body_type') in ['curvy','plus_size']:
        print(t['id'], t['name'], t['ethnicity'])
"
# By ethnicity + gender
cat models-catalog/catalog/catalog.json | jq '[.talents[] | select(.ethnicity == "hispanic" and .gender == "female") | {id, name, body_type}]'
```

## Creative Brief — How to Write It

Write it as a **real photography director's brief** — specific, physical, cinematic:

### Example: CasanCrem Light (ironic/viral UGC angle)
```
Campaña UGC TikTok para CasanCrem Light La Serenísima.
Joven de contextura robusta sostiene el pote con sonrisa cómplice en cocina hogareña argentina.
Pose relajada, apoyada en la mesada, mirando directo a cámara con energía y complicidad.
El pote visible y protagonista en la mano. Luz de ventana natural, cálida de tarde.
Estilo UGC auténtico, no publicitario clásico. Cuerpo real, relatable, no atlético.
```

### Example: Oakley Snowboarding
```
Oakley snowboarding campaign. Rider on metal rail in snowpark, body slightly rotated,
arms open for balance, eyes on the line. Technical authentic freestyle pose.
Alpine snowpark, full midday daylight, compacted snow, metal structures.
Natural sun bouncing off snow — saturated colors, strong contrast.
Documentary approach — freeze rider on rail, sharp body and board.
Real session frame: balance, concentration, style merged.
```

## Configuration Packs Reference

| Pack | Options |
|------|---------|
| `style_pack` | `premium_restraint`, `editorial_precision`, `cinematic_realism`, `cinematic_memory`, `campaign_hero`, `product_truth`, `clean_commercial`, `street_authentic`, `archive_fashion`, `experimental_authorial` |
| `shot_pack` | `full_body_wide`, `medium_shot`, `close_up`, `low_angle_hero`, `three_quarter`, `waist_up` |
| `camera_pack` | `arri_alexa35`, `canon_r5`, `hasselblad_x2d`, `leica_m6`, `sony_a1` |
| `lens_pack` | `cooke_anamorphic_i_50`, `leica_noctilux_50`, `zeiss_otus_55`, `wide_distortion_controlled` |
| `lighting_pack` | `golden_hour_backlit`, `natural_window`, `studio_three_point`, `bright_midday_sun` |
| `pose_discipline_pack` | `commercial_front_facing`, `street_style_candid_walk`, `sport_in_motion` |
| `film_texture_pack` | `kodak_portra_400`, `fujifilm_velvia_50`, `kodak_vision3_500t`, `digital_clean_no_emulation` |
| `color_science_pack` | `neutral_premium_clean`, `warm_golden_editorial`, `cinematic_low_contrast` |
| `environment_pack` | `beach_minimal`, `urban_glass_steel`, `street_crosswalk` — or custom descriptive string |
| `time_weather_pack` | `golden_hour_clear`, `bright_midday_sun`, `overcast_winter_daylight` |
| `branding_pack` | `logo_none` ← always unless logo explicitly requested |
| `intent` | `awareness`, `consideration`, `conversion`, `retention` |
| `aspect_ratio` | `9:16`, `16:9`, `1:1`, `4:5`, `3:4` |

## Python Upload Helper

```python
def comfy_upload(filepath: str, api_key: str) -> str:
    from pathlib import Path
    import requests
    p = Path(filepath)
    mime = "image/png" if p.suffix == ".png" else "image/jpeg"
    with open(p, "rb") as f:
        r = requests.post(
            "https://api.comfydeploy.com/api/file/upload",
            headers={"Authorization": f"Bearer {api_key}"},
            files={"file": (p.name, f, mime)},
            timeout=60
        )
    r.raise_for_status()
    return r.json()["file_url"]
```

## Priority Hierarchy

```
Talent (identity) > Product fidelity > Fit > Pose > Style > Location > Branding
```

## Troubleshooting

**Imagen negra/vacía** = filtro de moderación de Google/Gemini activado.
- No usar personas famosas o celebridades
- Modificar el brief eliminando referencias problemáticas

**API Key:** NO pasar como parámetro. Ya está configurado en ComfyDeploy.

## Integración con Portrait Generator

### Flujo de selección de modelo (actualizado)

El campo `model` puede venir de dos fuentes:

**Opción A — Catálogo (default):**
```
~/clawd/models-catalog/catalog/images/model_XX.jpg
```
Usar cuando el guión no requiere rasgos muy específicos.

**Opción B — Portrait Generator (cuando el guión lo requiere):**
```
portrait-generator → imagen_1 (vista frontal) → model en Morpheus
```
Usar cuando necesitás: etnia muy específica, edad exacta, rasgos únicos, personaje
que no existe en el cat