Higgsfield Soul Character

Que fait Higgsfield Soul Character ?

Entraînez un modèle d'identité fidèle au visage. Réutilisable sur toutes les générations basées sur un Soul.

Étape 0 — Amorçage

Avant toute autre commande :

1. Si higgsfield n'est pas dans $PATH, installez-le :

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

2. Si higgsfield account status échoue avec Session expired / Not authenticated, demandez à l'utilisateur d'exécuter higgsfield auth login (interactif) et attendez la confirmation.
3. L'entraînement d'un Soul nécessite un abonnement payant (Basic+). Si higgsfield account status affiche un plan gratuit, informez l'utilisateur avant de soumettre.

Règles UX

1. Soyez concis. Pas d'identifiants bruts dans le chat. Dites simplement « Soul prêt » avec une référence de nom.
2. Détectez la langue et répondez dans celle-ci. Les options CLI restent en anglais.
3. Demandez le plus petit ensemble d'entrées : nom + photos. Choisissez une variante de modèle adaptée.
4. Le suivi est silencieux — l'entraînement prend quelques minutes. Ne répétez pas les mises à jour de statut.

Workflow

1. Obtenir le nom. Un mot, utilisé pour référence ultérieure. Demandez s'il manque.
2. Obtenir les photos. 5 à 20 photos de visage, angles et éclairages variés. Les chemins locaux ou les identifiants déjà téléchargés fonctionnent — --image accepte les deux.
3. Choisir la variante.
   • --soul-2 — pour la génération d'images (par défaut)
   • --soul-cinematic — pour un travail cinématographique / vidéo Choisissez en fonction de l'utilisation ultérieure déclarée par l'utilisateur. Par défaut, --soul-2.
4. Soumettre.

   higgsfield soul-id create --name "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ...
   higgsfield soul-id create --name "<name>" --soul-2 --image <upload_id> --image <upload_id> ...
   

   Le CLI télécharge automatiquement les chemins. Capture l'ID de référence retourné.
5. Attendre. higgsfield soul-id wait <id>. Silencieux. Timeout par défaut 30 min.
6. Livrer. « Soul <name> prêt. Utilisez dans la génération avec --soul-id <id>. »

Utiliser le Soul

Une fois entraîné, passez-le à 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

Lister les Souls existants

higgsfield soul-id list                   # toutes les références
higgsfield soul-id get <id>               # une par ID

Erreurs

• Minimum Basic plan required — l'utilisateur est sur le plan gratuit ; informez-le.
• Training failed — vérifiez la qualité des photos (5+ visages uniques, bien éclairés).
• Session expired → higgsfield auth login.

Documentation de référence

• references/photo-guide.md — quelles photos fonctionnent le mieux
• references/troubleshooting.md — échecs d'entraînement courants