Higgsfield Soul Character (Personaje Alma)

Personaje Alma (Soul Character) de Higgsfield

Entrena un modelo de identidad facial fiel al rostro de una persona. Reutilizable en todas las generaciones potenciadas por Soul.

Paso 0 — Preparación

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 que ejecute higgsfield auth login (interactivo) y espera la confirmación.
3. El entrenamiento de un Alma requiere un plan de pago (Basic+). Si higgsfield account status muestra un plan gratuito, informa al usuario antes de continuar.

Reglas de UX

1. Sé conciso. No muestres IDs en bruto en el chat. Solo di "Alma lista" con una referencia al nombre.
2. Detecta el idioma y responde en él. Las banderas de CLI permanecen 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 referencias posteriores. Pregunta si falta.
2. Obtén las fotos. De 5 a 20 fotos del rostro, con diferentes ángulos e iluminación. Las rutas locales o los IDs ya subidos funcionan: --image acepta ambos.
3. Elige la variante.
   • --soul-2 — para generación de imágenes (predeterminada)
   • --soul-cinematic — para trabajo cinematográfico / video Elige según el uso final indicado por el usuario. Por defecto, --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_subido> --image <id_subido> ...
   

   El 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 minutos.
6. Entrega. "Alma <nombre> lista. Úsala en generación 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; infórmale.
• Training failed — verifica la calidad de las fotos (5+ rostros únicos, bien iluminados).
• Session expired → higgsfield auth login.

Documentos de referencia

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