Sesión Fotográfica de Producto
Generación de imágenes de marca mediante el comando higgsfield product-photoshoot create. La CLI llama a un potenciador de prompts backend que contiene vocabulario fotográfico y plantillas estructurales específicas para cada modo, luego envía la solicitud a gpt_image_2 y devuelve las URLs de las imágenes.
Paso 0 — Inicialización
Antes de cualquier otro comando:
- Si
higgsfieldno está en$PATH, instálalo:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - Si
higgsfield account statusfalla conSession expired/Not authenticated, pide al usuario que ejecutehiggsfield auth login(interactivo) y espera confirmación.
Reglas UX
- Sé conciso. Imprime solo las URLs de las imágenes en la respuesta final.
- Detecta el idioma, responde en él. Los nombres de los modos y las banderas de la CLI se mantienen en inglés.
- Haz como máximo 4 preguntas cortas antes de enviar. Usa opciones etiquetadas, nunca abiertas.
- Omite preguntas cuya respuesta sea obvia del contexto (imagen subida, turno anterior, memoria de marca).
- Nunca escribas el prompt de gpt_image_2 tú mismo — el backend lo ensambla.
- El polling es silencioso. Espera hasta que las URLs estén listas, luego entrégalas.
Modos
| Modo | Cuando el usuario quiere… |
|---|---|
product_shot | Producto sobre fondo neutro / estudio / catálogo |
lifestyle_scene | Producto en entorno real, manos, acción, atmósfera |
closeup_product_with_person | Primer plano con manos / rostro parcial — aplicación de belleza, sosteniendo, demostrando |
moodboard_pin | Estética vertical 2:3 nativa de Pinterest, estilo moodboard |
hero_banner | Formato ancho para sitio web / email / cabecera de campaña |
social_carousel | 3–10 diapositivas conectadas para IG / LinkedIn / Facebook |
ad_creative_pack | Paquete coordinado de variantes de anuncios estáticos para Meta / TikTok / Pinterest / Google Ads |
virtual_model_tryout | Producto usado o utilizado por un modelo generado por IA |
conceptual_product | Producto surrealista / estilo CGI / levitando / salpicadura / escultórico |
restyle | Transformar la estética, el ambiente o el contexto estacional de una imagen existente |
Selección de modo
Elige por intención, no por palabra clave superficial. Cuando dos modos puedan aplicarse, prefiere el más específico.
- producto + neutro / limpio / blanco / estudio / catálogo / Shopify →
product_shot - producto + escena / en uso / cocina / exterior / cafetería / gimnasio →
lifestyle_scene - manos sosteniendo / rostro con producto / aplicación de belleza / demostrando →
closeup_product_with_person - Pinterest, pin, pin vertical →
moodboard_pin - héroe, banner, cabecera de sitio web, página de aterrizaje, cabecera de email, formato ancho →
hero_banner - carrusel, publicación de diapositivas, multi-diapositiva, deslizable →
social_carousel - anuncios, paquete de anuncios, pago social, anuncios Meta / TikTok / Pinterest →
ad_creative_pack - modelo usando, prueba virtual, sobre el cuerpo, sesión de moda, lookbook →
virtual_model_tryout - levitando, flotando, salpicadura, movimiento congelado, surrealista, CGI, escultórico →
conceptual_product - modificar la estética, el ambiente o la temporada de una imagen EXISTENTE — sin cambiar el sujeto →
restyle
Desempates:
- "Pin de Pinterest de mi producto sobre una encimera de cocina" →
moodboard_pin(Pinterest es la plataforma) - "Banner héroe mostrando mi producto en uso" →
hero_banner(el formato de banner gana) - "Carrusel de mi producto en diferentes escenas" →
social_carousel(multi-diapositiva gana) - "Primer plano de una persona aplicando mi suero" →
closeup_product_with_person(el género específico gana)
Entrevista previa a la generación
Haz 3–4 preguntas cortas antes de enviar. Siempre opciones etiquetadas, nunca abiertas. Omite una pregunta cuya respuesta sea obvia del contexto.
Tipo A — subió una foto de producto, "hazme imágenes / sesiones fotográficas"
- ¿Cuántas?
[1 / 3 / 5] - ¿Qué estilo/ambiente?
[Estudio limpio / Estilo de vida / Conceptual / Con un modelo / Otro] - ¿Dónde las usarás?
[Shopify / Instagram / Pinterest / Anuncios de pago / Héroe del sitio web] - ¿Colores de marca a considerar? (omite si es obvio)
Tipo B — subió una foto de producto, mencionó un caso de uso
Ej. "haz anuncios para mi producto", "haz un pin de Pinterest", "haz un banner héroe". El modo es obvio. Pregunta solo lo que falte:
- ¿Cuántas? (si es modo de salida múltiple)
- ¿Cuál es la oferta / ambiente / gancho?
- ¿Algo en particular a enfatizar?
Tipo C — solo texto, sin foto de producto
- ¿Puedes subir una foto del producto? (preferible — mucha mayor fidelidad)
- Si no, describe el producto — categoría, empaque, color, características distintivas.
- ¿Qué estilo? (mismas opciones que Tipo A)
- ¿Dónde lo usarás?
Tipo D — subió una imagen existente, "rehacer / cambiar el ambiente / versión diferente"
→ restyle
- ¿Qué estética?
[Chica limpia / Cottagecore / Lujo tranquilo / Dark academia / Y2K / Otro] - ¿Contexto estacional?
[Navidad / San Valentín / Halloween / Black Friday / Ninguno] - ¿Qué conservar, qué cambiar? (solo si es ambiguo)
Tipo E — modelo usando un producto (moda, accesorios)
→ virtual_model_tryout
- ¿Arquetipo de modelo? (sugiere 2–3 basados en la audiencia de la marca)
- ¿Entorno?
[Estudio limpio / Exterior natural / Estilo callejero / Editorial / Hogar acogedor] - ¿Encuadre?
[Cuerpo entero / Tres cuartos / De cintura para arriba / Primer plano en el área del producto]
Tipo F — solicitud vaga, tema poco claro
Ej. "hazme algo genial para mi marca".
- ¿Qué producto o tema?
- ¿Objetivo?
[Vender en un marketplace / Crear conciencia / Ejecutar anuncios de pago / Actualizar sitio web] - ¿Subir una imagen de referencia?
Después de las respuestas → regresa al Tipo A–E relevante.
Generación
Comando único. El backend ensambla el prompt final y lo envía a gpt_image_2. Las URLs se imprimen en stdout.
higgsfield product-photoshoot create \
--mode <modo> \
--prompt "<descripción corta de la intención del usuario a partir de las respuestas de la entrevista>" \
[--image <ruta-o-id-de-subida>]... \
[--count <1-10>] \
[--aspect_ratio <anulación>]
Ejemplos:
higgsfield product-photoshoot create \
--mode lifestyle_scene \
--prompt "botella de café frío sobre una encimera soleada, feed de IG" \
--image bottle.jpg \
--count 3
higgsfield product-photoshoot create \
--mode moodboard_pin \
--prompt "pin vertical para mi marca de velas, ambiente cottagecore" \
--image candle.jpg
higgsfield product-photoshoot create \
--mode restyle \
--prompt "versión navideña, estética de lujo tranquilo" \
--image existing-shot.jpg
Entradas de imagen
--image acepta una ruta de archivo local (se sube automáticamente) O un UUID de subida existente. Repite la bandera para múltiples referencias.
Multivariante
--count 3 devuelve 3 URLs de imágenes distintas. El backend pide al potenciador que varíe preajuste, iluminación, ángulo y paleta entre las variantes — no serán copias parafraseadas entre sí.
Para social_carousel y ad_creative_pack, count = número de diapositivas / variantes en el paquete. El backend bloquea el sistema visual en todas las diapositivas automáticamente.
Relación de aspecto
El backend elige un valor predeterminado sensato por modo. Anula con --aspect_ratio solo si el usuario lo solicita explícitamente. Valores permitidos: 1:1, 4:5, 5:4, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9.
Resolución
Usa 2k para cada trabajo de product-photoshoot.
Entrega de resultados
Imprime las URLs de las imágenes como una lista breve con viñetas. Sin JSON, sin IDs, sin nombres de modelos internos, sin texto de prompt mejorado. Si un trabajo falló, menciónalo brevemente con el estado del fallo.
3 imágenes de estilo de vida listas:
- https://cdn.higgsfield.ai/.../job_abc.jpg
- https://cdn.higgsfield.ai/.../job_def.jpg
- https://cdn.higgsfield.ai/.../job_ghi.jpg
Qué NO hace esta habilidad
- No escribe prompts de gpt_image_2 directamente. El backend es dueño del ensamblaje del prompt.
- No elige automáticamente un modelo de generación de imágenes diferente. Siempre
gpt_image_2. - No reemplaza
higgsfield-generateMarketing Studio para flujos de trabajo de video / avatar de marca. - No reemplaza
higgsfield-generatepara texto a imagen sin un contexto de producto o marca.
Errores comunes a evitar
- Hacer más de 4 preguntas de entrevista en un solo mensaje.
- Elegir el modo incorrecto (ej.
product_shotcuando el usuario quiere un pin de Pinterest). - Llamar directamente a
higgsfield generate create gpt_image_2 --prompt ...en lugar dehiggsfield product-photoshoot create— esto evita el potenciador de prompts y produce resultados notablemente peores. - Pegar de vuelta al usuario el prompt ensamblado — ellos quieren las URLs.
- Usar un valor
--modeque no esté en la tabla anterior.