Higgsfield Soul Character

Train a reusable face identity model for personalized image and video generation.

- Requires 5–20 face photos from varied angles and lighting; accepts local file paths or pre-uploaded image IDs

- Two model variants: --soul-2 for image generation (default) and --soul-cinematic for video work

- Returns a reference ID after training completes, then pass to higgsfield-generate with --soul-id flag to generate identity-faithful content

- Requires paid plan (Basic+) and authenticated session via higgsfield auth login

Higgsfield Soul Character

Train a face-faithful identity model. Reusable across all Soul-powered generations.

Step 0 - Bootstrap

Before any other command:

- If higgsfield is not on $PATH, install it:

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

- If higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.

- Soul training requires a paid plan (Basic+). If higgsfield account status shows free plan, tell the user before submitting.

UX Rules