Alma de Higgsfield (Soul Character)

¿Qué hace Alma de Higgsfield (Soul Character)?

Entrena un modelo fiel al rostro. Reutilizable en todas las generaciones impulsadas por Alma (Soul).

Paso 0 — Inicio

Antes de cualquier otro comando:

1. Si higgsfield no está en $PATH, instálalo:

   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   

2. Si higgsfield account status falla con Session expired / Not authenticated, pide al usuario ejecutar higgsfield auth login (interactivo) y espera confirmación.
3. El entrenamiento de Alma requiere un plan de pago (Basic+). Si higgsfield account status muestra un plan gratuito, informa al usuario antes de enviar.

Reglas de UX

1. Sé conciso. No muestres IDs sin procesar en el chat. Solo di "Alma lista" con una referencia de nombre.
2. Detecta el idioma y responde en él. Las banderas CLI se mantienen en inglés.
3. Pide el conjunto más pequeño de entradas: nombre + fotos. Elige una variante de modelo sensata.
4. La espera es silenciosa: el entrenamiento toma minutos. No repitas actualizaciones de estado.

Flujo de trabajo

1. Obtén el nombre. Una palabra, usada para referencia posterior. Pregunta si falta.
2. Obtén las fotos. 5–20 fotos del rostro, con ángulos e iluminación variados. Tanto rutas locales como IDs ya subidos funcionan — --image acepta ambos.
3. Elige la variante.
   • --soul-2 — para generación de imágenes (predeterminado)
   • --soul-cinematic — para trabajo cinematográfico / video Elige según el uso final indicado por el usuario. Por defecto usa --soul-2.
4. Envía.

   higgsfield soul-id create --name "<nombre>" --soul-2 --image ./foto1.png --image ./foto2.png ...
   higgsfield soul-id create --name "<nombre>" --soul-2 --image <id_subida> --image <id_subida> ...
   

   La CLI sube automáticamente las rutas. Captura el ID de referencia devuelto.
5. Espera. higgsfield soul-id wait <id>. Silencioso. Tiempo de espera predeterminado 30 min.
6. Entrega. "Alma <nombre> lista. Úsala en generate con --soul-id <id>."

Usar el Alma

Una vez entrenada, pásala a higgsfield-generate:

higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --quality 2k --wait
higgsfield generate create soul_cinematic --prompt "..." --soul-id <ref_id> --quality 2k --wait

Listar Almas existentes

higgsfield soul-id list                   # todas las referencias
higgsfield soul-id get <id>               # una por id

Errores

• Minimum Basic plan required — el usuario está en plan gratuito; díselo.
• Training failed — verifica la calidad de las fotos (5+ rostros únicos, bien iluminados).
• Session expired → higgsfield auth login.

Documentación de referencia

• references/photo-guide.md — qué fotos funcionan mejor
• references/troubleshooting.md — fallos comunes de entrenamiento