Higgsfield Soul Character
Trainieren Sie ein gesichtstreues Identitätsmodell. Wiederverwendbar bei allen Soul-gestützten Generierungen.
Schritt 0 – Bootstrap
Vor jedem anderen Befehl:
- Falls
higgsfieldnicht im$PATHist, installieren Sie es:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - Falls
higgsfield account statusmit „Session expired“ / „Not authenticated“ fehlschlägt, bitten Sie den Benutzer,higgsfield auth login(interaktiv) auszuführen, und warten Sie auf die Bestätigung. - Soul-Training erfordert einen kostenpflichtigen Tarif (Basic+). Falls
higgsfield account statuseinen kostenlosen Tarif anzeigt, informieren Sie den Benutzer vor dem Absenden.
UX-Regeln
- Seien Sie prägnant. Keine rohen IDs im Chat. Sagen Sie einfach „Soul bereit“ mit einer Namensreferenz.
- Erkennen Sie die Sprache und antworten Sie darin. CLI-Flags bleiben auf Englisch.
- Fragen Sie nach der kleinsten Menge an Eingaben: Name + Fotos. Wählen Sie eine sinnvolle Modellvariante.
- Polling erfolgt still – das Training dauert Minuten. Wiederholen Sie keine Statusaktualisierungen.
Arbeitsablauf
- Namen abfragen. Ein Wort, das später zur Referenz verwendet wird. Fragen Sie, falls er fehlt.
- Fotos holen. 5–20 Gesichtsfotos mit verschiedenen Winkeln und Lichtverhältnissen. Lokale Pfade oder bereits hochgeladene IDs funktionieren beide –
--imageakzeptiert beides. - Variante wählen.
--soul-2– für Bildgenerierung (Standard)--soul-cinematic– für filmische / Video-Arbeiten Wählen Sie basierend auf dem vom Benutzer angegebenen Downstream-Einsatz. Standardmäßig--soul-2.
- Absenden.
Die CLI lädt Pfade automatisch hoch. Erfasst die zurückgegebene Referenz-ID.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> ... - Warten.
higgsfield soul-id wait <id>. Still. Standard-Timeout 30m. - Ausliefern. „Soul
<name>bereit. Verwenden Sie in generate mit--soul-id <id>.“
Soul verwenden
Nach dem Training an higgsfield-generate übergeben:
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
Vorhandene Souls auflisten
higgsfield soul-id list # alle Referenzen
higgsfield soul-id get <id> # eine nach ID
Fehler
Minimum Basic plan required– Der Benutzer hat einen kostenlosen Tarif; informieren Sie ihn.Training failed– Überprüfen Sie die Fotoqualität (5+ eindeutige Gesichter, gut beleuchtet).Session expired→higgsfield auth login.
Referenzdokumente
references/photo-guide.md– welche Fotos am besten funktionierenreferences/troubleshooting.md– häufige Trainingsfehler