Personnage IA (Higgsfield Soul Character)
Créez un modèle d'identité fidèle au visage. Réutilisable pour toutes les générations basées sur un Personnage.
Étape 0 — Amorçage
Avant toute autre commande :
- Si
higgsfieldn'est pas dans le$PATH, installez-le :curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - Si
higgsfield account statuséchoue avecSession expirée/Non authentifié, demandez à l'utilisateur d'exécuterhiggsfield auth login(interactif) et attendez la confirmation. - L'entraînement d'un Personnage nécessite un plan payant (Basic+). Si
higgsfield account statusaffiche un plan gratuit, prévenez l'utilisateur avant de soumettre.
Règles UX
- Soyez concis. Pas d'identifiants bruts dans le chat. Dites simplement « Personnage prêt » avec une référence de nom.
- Détectez la langue et répondez dans celle-ci. Les indicateurs CLI restent en anglais.
- Demandez le plus petit ensemble d'entrées : nom + photos. Choisissez une variante de modèle sensée.
- L'interrogation est silencieuse — l'entraînement prend des minutes. Ne répétez pas les mises à jour de statut.
Flux de travail
- Obtenir le nom. Un mot, utilisé comme référence ultérieure. Demandez s'il manque.
- 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 tous les deux —
--imageaccepte les deux. - Choisir la variante.
--soul-2— pour la génération d'images (par défaut)--soul-cinematic— pour le travail cinématographique / vidéo Choisissez en fonction de l'utilisation aval déclarée par l'utilisateur. Par défaut--soul-2.
- Soumettre.
La CLI télécharge automatiquement les chemins. Capture l'identifiant de référence retourné.higgsfield soul-id create --name "<nom>" --soul-2 --image ./photo1.png --image ./photo2.png ... higgsfield soul-id create --name "<nom>" --soul-2 --image <upload_id> --image <upload_id> ... - Attendre.
higgsfield soul-id wait <id>. Silencieux. Délai d'attente par défaut de 30 minutes. - Livrer. « Personnage
<nom>prêt. Utilisez dans generate avec--soul-id <id>. »
Utiliser le Personnage
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 Personnages existants
higgsfield soul-id list # toutes les références
higgsfield soul-id get <id> # une par identifiant
Erreurs
Plan Minimum Basic requis— l'utilisateur est sur le plan gratuit ; prévenez-le.Échec de l'entraînement— vérifiez la qualité des photos (5+ visages uniques, bien éclairés).Session expirée→higgsfield auth login.
Documentation de référence
references/photo-guide.md— les photos qui fonctionnent le mieuxreferences/troubleshooting.md— échecs d'entraînement courants