📦 Higgsfield Soul ID

Higgsfield Soul Character 训练一个忠实还原面部的身份模型，可在所有 Soul 驱动的生成中复用。

Step 0 — Bootstrap 在任何命令前： 若 $PATH 中无 higgsfield，先安装： curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

若 higgsfield account status 提示 Session expired / Not authenticated，请用户运行 higgsfield auth login（交互式），等待确认。 Soul 训练需付费套餐（Basic+ 及以上）。若账户为免费套餐，提前告知。

UX 规则 简洁；聊天中不出现原始 ID；仅说“Soul 就绪”。 检测用户语言并用同语言回复；CLI 参数保持英文。 仅索取最少信息：名字 + 照片。 自动选合适模型变体；轮询静默，训练耗时数分钟，不重复状态。

Workflow

• 取名字

一个单词，供后续引用；缺失时询问。

• 取照片

5–20 张人脸照片，角度与光线多样。 本地路径或已上传 ID 均可；--image 同时支持。

• 选变体

--soul-2 — 图像生成（默认） --soul-cinematic — 电影/视频用途 按用户后续用途选择，默认 --soul-2。

• 提交

higgsfield soul-id create --name "" --soul-2 --image ./photo1.png --image ./photo2.png … 或 higgsfield soul-id create --name "" --soul-2 --image --image … CLI 自动上传路径并捕获返回的引用 id。

• 等待

higgsfield soul-id wait 静默执行，默认超时 30 分钟。

• 交付

“Soul 就绪。生成时使用 --soul-id 。”

使用 Soul 训练完成后，传给 higgsfield-generate： higgsfield generate create text2image_soul_v2 --prompt "…" --soul-id --wait 或 higgsfield generate create soul_cinema_studio --prompt "…" --soul-id --wait

列出已有 Souls higgsfield soul-id list # 全部引用 higgsfield soul-id get # 单个详情

错误提示

• 需 Basic 套餐：用户为免费套餐，请升级。
• 训练失败：检查照片质量（≥5 张不同人脸，光线良好）。
• Session expired → 请运行 higgsfield auth login。

参考文档 references/photo-guide.md — 最佳照片示例 references/troubleshooting.md — 常见训练失败原因