Back to Details

higgsfield-soul-id

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Higgsfield Soul Character

Higgsfield Soul Character

Train a face-faithful identity model. Reusable across all Soul-powered generations.
训练忠实还原人脸特征的身份模型。可在所有基于Soul的生成任务中重复使用。

Step 0 — Bootstrap

步骤0 — 准备工作

Before any other command:
  1. If 
    higgsfield
    is not on 
    $PATH
    , install it:
    bash
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
  2. If 
    higgsfield account status
    fails with 
    Session expired
    / 
    Not authenticated
    , ask the user to run 
    higgsfield auth login
    (interactive) and wait for confirmation.
  3. Soul training requires a paid plan (Basic+). If 
    higgsfield account status
    shows free plan, tell the user before submitting.
在执行任何其他命令前：
  1. 如果
    higgsfield
    不在
    $PATH
    中，请安装它：
    bash
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
  2. 如果
    higgsfield account status
    返回
    Session expired
    （会话过期）或
    Not authenticated
    （未认证），请让用户运行
    higgsfield auth login
    （交互式登录）并等待确认。
  3. Soul训练需要付费套餐（基础版及以上）。如果
    higgsfield account status
    显示为免费套餐，请在提交前告知用户。

UX Rules

用户体验规则

  1. Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.
  2. Detect language and respond in it. CLI flags stay English.
  3. Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.
  4. Polling is silent — training takes minutes. Don't repeat status updates.
  1. 保持简洁。聊天中不要显示原始ID，只需告知“Soul已准备就绪”并附上名称标识。
  2. 检测用户语言并使用对应语言回复。CLI参数保持英文。
  3. 仅请求必要的最少输入：名称+照片。选择合适的模型变体。
  4. 轮询过程静默进行——训练需要数分钟。不要重复发送状态更新。

Workflow

工作流程

  1. Get name. One word, used for later reference. Ask if missing.
  2. Get photos. 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work — 
    --image
    accepts either.
  3. 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
      .
  4. Submit.
    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. Wait. 
    higgsfield soul-id wait <id>
    . Silent. Default timeout 30m.
  6. Deliver. "Soul 
    <name>
    ready. Use in generate with 
    --soul-id <id>
    ."
  1. 获取名称：单个单词，用于后续标识。如果缺失请询问用户。
  2. 获取照片：5-20张人脸照片，包含不同角度和光线条件。本地路径或已上传的ID均可——
    --image
    参数支持两种格式。
  3. 选择模型变体： 
    • --soul-2
      — 用于图像生成（默认选项）
    • --soul-cinematic
      — 用于电影级/视频制作 根据用户说明的后续用途选择，默认使用
      --soul-2
      。
  4. 提交训练：
    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会自动上传本地路径的文件。捕获返回的reference_id。
  5. 等待完成：
    higgsfield soul-id wait <id>
    。静默执行，默认超时时间30分钟。
  6. 交付结果：“Soul 
    <name>
    已准备就绪。请在生成任务中使用
    --soul-id <id>
    参数。”

Use the Soul

使用Soul模型

Once trained, pass to 
higgsfield-generate
:
bash
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --wait
higgsfield generate create soul_cinema_studio --prompt "..." --soul-id <ref_id> --wait
训练完成后，将其传入
higgsfield-generate
：
bash
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --wait
higgsfield generate create soul_cinema_studio --prompt "..." --soul-id <ref_id> --wait

Listing existing Souls

列出已有的Soul模型

bash
higgsfield soul-id list                   # all references
higgsfield soul-id get <id>               # one by id
bash
higgsfield soul-id list                   # 列出所有标识
higgsfield soul-id get <id>               # 根据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
    .
  • Minimum Basic plan required
    — 用户当前为免费套餐，请告知用户。
  • Training failed
    — 检查照片质量（需5张以上不同角度的清晰人脸，光线充足）。
  • Session expired
    → 执行
    higgsfield auth login
    重新登录。

Reference docs

参考文档

  • references/photo-guide.md
    — what photos work best
  • references/troubleshooting.md
    — common training failures
  • references/photo-guide.md
    — 最佳照片指南
  • references/troubleshooting.md
    — 常见训练失败问题排查