higgsfield-soul-id
We need to translate the given English text into Japanese, preserving the name "higgsfield-soul-id" and other technical terms. The text describes a skill for training a Soul Character. We must not add any extra commentary or labels. The translation should be natural Japanese while keeping product names, protocol names, URLs, numbers, and technical terms as-is. The name "higgsfield-soul-id" appears in the text as part of a command example. Also note "Higgsfield" is a product name, so keep it. "Soul Character" might be translated as "ソウルキャラクター" or keep as "Soul Character"? The instruction says preserve product names, so "Higgsfield" and "Soul" likely should remain. But "Soul Character" could be translated as "ソウルキャラクター" but the original uses "Soul Character" as a term. I'll keep "Soul Character" as is. Similarly, "reference_id", "text2image_soul_v2" are technical terms. The
npx skills add https://github.com/higgsfield-ai/skills --skill higgsfield-soul-idHiggsfield Soul Character
Train a face-faithful identity model. Reusable across all Soul-powered generations.
Step 0 — Bootstrap
Before any other command:
- If
higgsfieldis not on$PATH, install it:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh - If
higgsfield account statusfails withSession expired/Not authenticated, ask the user to runhiggsfield auth login(interactive) and wait for confirmation. - Soul training requires a paid plan (Basic+). If
higgsfield account statusshows free plan, tell the user before submitting.
UX Rules
- Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.
- Detect language and respond in it. CLI flags stay English.
- Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.
- Polling is silent — training takes minutes. Don't repeat status updates.
Workflow
- Get name. One word, used for later reference. Ask if missing.
- Get photos. 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work —
--imageaccepts either. - Pick variant.
--soul-2— for image generation (default)--soul-cinematic— for cinematic / video work Choose based on user's stated downstream use. Default to--soul-2.
- Submit.
CLI auto-uploads paths. Captures returned reference 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> ... - Wait.
higgsfield soul-id wait <id>. Silent. Default timeout 30m. - Deliver. "Soul
<name>ready. Use in generate with--soul-id <id>."
Use the Soul
Once trained, pass to 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
Listing existing Souls
higgsfield soul-id list # all references
higgsfield soul-id get <id> # one by id
Errors
Minimum Basic plan required— user is on free plan; tell them.Training failed— check photos quality (5+ unique faces, well-lit).Session expired→higgsfield auth login.
Reference docs
references/photo-guide.md— what photos work bestreferences/troubleshooting.md— common training failures