higgsfield-soul

# Higgsfield Soul ID — Character Consistency

## QUICK FACTS
*Generated-checked block (build_index.py verifies anchors). Read the linked sections for full context — these lines are routing aids, not the rules themselves.*
- Hard rule: every Soul ID prompt splits into Identity Block (static descriptors only) + Motion Block (temporal/camera only) [→](#identity-vs-motion-separation-hard-rule)
- Don't re-describe the face or core features — only describe what differs from the base character [→](#prompting-with-soul-id)
- Reference image rules: front or 3/4 angle, even lighting, neutral-to-slight expression, no blur, solo subject [→](#creating-a-strong-soul-id-reference)
- Reference generators: Soul 2.0 (fashion-forward), Nano Banana Pro (max sharpness), Seedream 4.5 (style range) [→](#creating-a-strong-soul-id-reference)
- Character sheet angles: front face, 3/4, side profile, optional full body + optional embedded prop sheets [→](#character-sheet-creation)
- Prefer the single-prompt 3×2 six-panel sheet (one 16:9 generation) — identity locks better than multi-step assembly [→](#single-prompt-6-panel-character-sheet-32-grid)
- Character Anchor Block = 10 per-shot attributes (identity, screen position, depth layer, frame occupancy, orientation, pose, gaze, contact points, state lock, expression) [→](#character-anchor-block)
- One Soul ID sheet PER character state — 5 transformation stages = 5 distinct sheets; the prompt names the stage [→](#multi-form-state-tracking)
- Micro-expression presets: 9 core + 10 extended [→](#core-set)
- Cinema Studio: identity goes in the @ Element definition, motion goes in the prompt field [→](#beforeafter-examples)
- Soul Cast is Business/Team plans only; 8 parameter categories incl. 12 Archetypes, Budget $10M–$500M, Era 1900s–2020s [→](#cinema-studio-30-soul-cast-businessteam-plan)
- Soul Cast specs: up to 4K (Character/Location modes) / 2K (General); batch 1 or 10; 0.125 credits per image [→](#30-soul-cast-specs)
- Use 2–3 reference shots (frontal, 3/4, side); if features drift, use the character sheet as @Image1 [→](#character-consistency-best-practices)
- Soul Cinema is the default CS 3.0/3.5 image-mode model — single-step, ~0.125 credits/image [→](#soul-cinema-as-the-cs-3035-default-image-model)
- Studio-feeling output is an intermediate, not a final — re-pass through Soul Cinema with grade, directional lighting, lens character [→](#studio-look-vs-cinematic-look-soul-cinema-as-the-re-pass)
- Skip Soul ID for single shots or when you want maximum creative variation [→](#when-to-use-soul-id)
- Plasticky face in wide shots: crop the face from a closer-shot panel and replace it in post [→](#face-from-wide-shot-workaround)


## What Is Soul ID?

Soul ID is Higgsfield's character consistency system. Create a character reference once,
then reuse it across unlimited generations — different scenes, angles, lighting, and
actions — while the face and core appearance remain consistent.

---

## How It Works

1. **Create a Soul ID** — Upload a reference image or generate one using Soul 2.0
2. **The platform stores the character** — assigns it an ID
3. **Reference in future prompts** — "using Soul ID character [name/reference]"
4. **Character stays consistent** — face, skin tone, basic features carry across generations

---

## When to Use Soul ID

✅ You're building a multi-shot sequence with the same character
✅ You're creating a short film / story with a recurring protagonist
✅ You're making an AI influencer or brand mascot
✅ You want consistent faces across a product ad campaign
✅ You're doing a multi-scene action sequence and need the hero to look the same

❌ Don't use if you only need one shot — overkill for single generations
❌ Don't use if you want maximum creative variation — consistency limits style range

---

## Prompting With Soul ID

When a Soul ID character is active, your prompt should:

**1. Reference the character simply:**
```
The Soul ID character walks through a crowded Tokyo street at night.
```

**2. Describe what changes — not what the character looks like:**
```
The Soul ID character now wears a formal black suit. She stands at a podium,
addressing a conference room. Camera: Dolly In toward her face.
Style: Cinematic, cool corporate lighting, 16:9.
```

**3. You can change clothing, setting, expression:**
```
The Soul ID character is now in a red dress, dancing alone in a ballroom.
Camera: 360 Orbit.
Style: Cinematic, warm golden chandelier light.
```

**Key rule:** Don't re-describe the face or core features — the Soul ID handles that.
Only describe what is *different* from the base character.

---

## Identity vs. Motion Separation — Hard Rule

When Soul ID is active, **every prompt MUST be split into two blocks**. This is the
single most important rule for preventing identity drift.

### Identity Block — Static descriptors only
Contains: face features, clothing, body type, distinguishing marks, color palette.
Does NOT contain: any motion, camera, speed, or temporal language.

### Motion Block — Temporal and camera only
Contains: camera movement, action choreography, speed, environmental changes.
Does NOT contain: any character appearance repetition.

### Before/After Examples

**Example 1 — Action scene:**

❌ **Mixed (bad) — causes identity drift:**
```
A tall woman with green eyes and freckles in a leather jacket sprints through
a warehouse while the camera tracks her and her green eyes flash with determination
and her freckles catch the fluorescent light as she vaults over a railing.
```
Face morphs mid-clip because the model re-reads face descriptors while processing motion.

✅ **Separated (good) — identity stays locked:**

**Identity Block:**
```
The Soul ID character — tall build, green eyes, light freckles across the nose
and cheeks, wearing a fitted black leather jacket, dark jeans.
```

**Motion Block:**
```
She sprints through a dimly lit warehouse, vaults over a metal railing
without breaking stride.
Camera: Action Run — low behind h