---
name: "higgsfield-generate"
description: "Generar imágenes y videos con Higgsfield AI. Usar cuando el usuario pida \"genera una imagen\", \"haz un video\", \"anima esta foto\", \"image-to-video\", \"edita/estiliza esta imagen\", \"produce un clip\", \"haz un anuncio\", banners, creativos, product shots, o cualquier generación visual con IA. Cubre GPT Image 2, Seedance 2.0, Nano Banana, Soul, Kling, Marketing Studio y Virality Predictor."
---

# Higgsfield Generate

Genera imágenes y videos con Higgsfield. Funciona por dos rutas — MCP o CLI — y elige sola cuál usar.

> **Canónico completo en disco:**
> `C:\Users\Med Lab\Documents\Clientes\Second Brain\agencia\motor\skills\higgsfield-generate\`
>
> Ese folder tiene el `SKILL.md` completo (316 líneas) más **12 archivos de `references/`**:
> catálogo de modelos, prompt engineering, Marketing Studio, avatares, productos,
> brand kits, media inputs, troubleshooting y la tabla CLI↔MCP.
>
> **Si la carpeta está conectada, leerla antes de generar.** Esta copia es sólo
> el enrutador — tiene lo esencial, no el detalle.

## Paso 0 — Elegir la ruta

1. **¿Hay herramientas MCP de Higgsfield?** (`images_generate`, `video_generate`, `creations_show`, `account_balance`) → **ruta MCP**. No tocar el CLI.
2. **¿Está `higgsfield` en el `$PATH`?** → **ruta CLI**.
3. **Ninguna** → instalar el CLI, o pedir al usuario que conecte el MCP de Higgsfield.

**Nunca mezclar las dos rutas en un mismo trabajo** — los identificadores no son intercambiables.

Detalle y tabla de equivalencias: `references/rutas-cli-vs-mcp.md`.

## Ruta MCP

- `account_balance` antes de generar — confirmar créditos.
- **Imagen:** `images_generate` → devuelve `identifier` → `creations_show(identifiers)` para que el usuario la vea. Obligatorio; esos resultados no traen `webUrl`.
- **Video:** `video_plan` primero (valida el slug del modelo) → `video_generate` → `creations_wait` sólo si se necesita la URL final para encadenar.
- **Encadenar imagen→video:** pasar el `identifier` de la creación previa, **nunca el `webUrl`**.
- **Archivos locales:** `creations_upload_show` abre un selector. Nunca pedir que adjunten al chat — el servidor no los lee.
- **Assets reutilizables:** `library_show` para que el usuario elija personaje, estilo, elemento o locación.

## Ruta CLI

```bash
# bootstrap si falta
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
higgsfield auth login          # si "Session expired"

# generar
higgsfield generate create <job_set_type> --prompt "..." [media] [params] --wait

# descubrir
higgsfield model list --json | jq
higgsfield model get <job_set_type> --json
```

`--wait` bloquea hasta terminar e imprime el resultado. Evitar el patrón `create` → `wait` en dos pasos.

## Elección de modelo

La lógica es idéntica en ambas rutas.

**Imagen**

- **Default para casi todo → GPT Image 2.** Diseño gráfico, UI, banners, tipografía, texto sobre imagen, alta fidelidad general.
- Personaje, cartoon, estilizado, trabajo con referencias → Nano Banana 2; Pro para casos difíciles.
- UGC estético, editorial de moda, lifestyle → Soul 2.0.
- Frame cinematográfico → Soul Cinema.
- Locaciones y ambientes sin personas → Soul Location.
- Ilustración vectorial o edición de rostro con cambio de escena → Seedream 4.5.
- Foto de producto de marca (pin, lifestyle, hero, try-on) → usar `higgsfield-product-photoshoot`, no este skill.
- Anuncio con avatar + producto → Marketing Studio.
- Iteración rápida y barata → Z Image.

**Video**

- **Default serio → Seedance 2.0.** Multi-toma, identidad consistente, movimiento fuerte, image-to-video, 4–15s. No bajar a 1.5 sin validar 2.0 primero.
- Publicidad, comercial, anuncio de marca → Marketing Studio.
- Escena de un solo plano, más barato → Kling 3.0.
- Fidelidad máxima cine → Cinema Studio Video 3.0.
- Física fuerte sin audio → Minimax Hailuo.
- Lotes rápidos → Veo 3.1 Lite.

**Análisis de video**

Puntuar hook, retención o potencial viral de un video terminado → Virality Predictor (`brain_activity`). Es video-in / texto-out, no genera media.

## Reglas

1. **Un clip generado = 15 segundos máximo.** Videos largos se arman uniendo clips.
2. Ser conciso. Nada de IDs crudos ni JSON en el chat. URL o vista previa, más una línea de resumen.
3. Sin jerga interna. No narrar "consultando costo", "haciendo polling".
4. Responder en el idioma del usuario. Los argumentos técnicos (`--aspect_ratio 16:9`) se quedan en inglés.
5. No preguntar en bloque. Elegir un default sensato y preguntar una sola cosa si falta de verdad.
6. Calidad primero. No optimizar hacia modelos baratos salvo que lo pidan.
7. Consistencia de personaje → entrenar Soul una vez y reusar la referencia. Ver `higgsfield-soul-id`.

## Dónde guardar

Para un activo con kit, conservar una foto real por vista dentro de `fotos/` y
crear una única `hoja-visual.jpg` que reúna las vistas del mismo activo. El
`identidad.json` referencia las fotos individuales y la Hoja Visual; la
`guia-creativa.md` explica la selección de cada foto. No insertar imágenes en
JSON o Markdown ni mezclar productos o accesorios en un mismo kit.

```
02-proyectos/{cliente}/outputs/imagenes/{campana}/
02-proyectos/{cliente}/outputs/videos/{campana}/
```

Nombre: `{fecha}_{cliente}_{formato}_{tema}_v{n}.{ext}`

Registrar la combinación producto × escenario × personaje en `outputs/entregas.md` para no repetir.
