/community/skills/higgsfield skills/higgsfield soul id
innernet
docsskillscommunitycompanycomparesecurityprivacytermscontact

a skill by Higgsfield, brought here by kt

higgsfield soul id

paste this link into your ai. it will know what to do.

/skills/higgsfield-soul-id

Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my Soul", "train my face", "make my digital twin", "build me an avatar", "learn my appearance", "create a character of me", "set up identity for video", "I want my face in generated images". Chain: train Soul (one-time, returns reference_id) → use in higgsfield-generate via `--soul-id <id>` with models like `text2image_soul_v2` or `soul_cinematic`. NOT for: one-shot face swaps (use higgsfield-generate with --image), named-character / non-phot

kindskill
version0.13.0
last tended2026-10-12
written byHiggsfield
sourcegithub.com/higgsfield-ai/skills
kept currentwith its source · last read 2026-10-12
in the folderhiggsfield skills · 5 of 8 · ‹ higgsfield product photoshoot · higgsfield video explainer ›
brought here bykt
reuseMIT
yours?it stays under your name. to change it or take it down, write to connect@innernet.live
reading2 min

Higgsfield Soul Character

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

Step 0 — Bootstrap

Before any other command:

  1. 1If higgsfield is not on $PATH, install it: ``bash curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh ``
  2. 2If higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.
  3. 3Soul training requires a paid plan (Basic+). If higgsfield account status shows free plan, tell the user before submitting.

UX Rules

  1. 1Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.
  2. 2Detect language and respond in it. CLI flags stay English.
  3. 3Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.
  4. 4Polling is silent — training takes minutes. Don't repeat status updates.

Workflow

  1. 1Get name. One word, used for later reference. Ask if missing.
  2. 2Get photos. 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work — --image accepts either.
  3. 3Pick 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.
  4. 4Submit. ``bash 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> ... `` CLI auto-uploads paths. Captures returned reference id.
  5. 5Wait. higgsfield soul-id wait <id>. Silent. Default timeout 30m.
  6. 6Deliver. "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

--soul-id is sent as the model's custom_reference_id. For a curated Soul style, list styles with higgsfield preset list soul-v2 and pass the chosen id as --style_id on text2image_soul_v2. --style_id cannot be combined with --image.

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 best
  • references/troubleshooting.md — common training failures

keep it where your ai can reach it.

innernet is memory your ai tools read live — every skill, every project, every decision, in one place, connected once. save this skill to yours, or publish one of your own as a link like this.

save it to your innernetsee every skill