mcpField
H
higgsfield-soul-id

higgsfield-soul-id

github.com/higgsfield-ai创意与媒体1.8k198.7k 次安装1 天前更新
代码仓库

关于 higgsfield-soul-id

higgsfield-soul-id 是使用 Higgsfield CLI 创建可复用人脸身份模型的工作流技能，涵盖照片提交、变体选择、训练及后续调用。

主要功能

  1. 01从照片创建 Soul 身份
  2. 02选择图像或电影变体
  3. 03等待训练完成
  4. 04列出并获取已有 Soul
  5. 05在生成任务中使用 Soul 引用

适用场景

  1. 01为图像生成准备可复用身份
  2. 02为电影或视频创作创建身份
  3. 03查看已有 Soul 引用

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/higgsfield-ai/skills --skill higgsfield-soul-id

安装后在 Claude Code 中输入/higgsfield-soul-id确认已加载。

附带文件references/photo-guide.mdreferences/troubleshooting.md

详细介绍

Higgsfield Soul 角色

训练一个忠实还原面部特征的身份模型。可在所有由 Soul 驱动的生成中重复使用。

步骤 0 — 初始化

执行其他任何命令之前：

  1. 如果 $PATH 中没有 higgsfield，请安装： 
    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 训练需要付费方案（Basic+）。如果 higgsfield account status 显示为免费方案，请在提交前告知用户。

UX 规则

  1. 保持简洁。聊天中不要显示原始 ID。只需提及名称并说“Soul 已就绪”。
  2. 检测语言并使用该语言回复。CLI 标志保持英文。
  3. 询问最少必要的信息：名称和照片。选择合适的模型变体。
  4. 静默轮询——训练需要几分钟。不要重复发送状态更新。

工作流

  1. 获取名称。 一个词，用于之后引用。如缺少名称，请询问。
  2. 获取照片。 5–20 张面部照片，角度和光线各不相同。本地路径或已上传的 ID 均可——--image 两者都接受。
  3. 选择变体。
    • --soul-2 — 用于图像生成（默认）
    • --soul-cinematic — 用于电影风格 / 视频创作 根据用户说明的后续用途进行选择。默认使用 --soul-2。
  4. 提交。 
    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>。静默等待。默认超时时间为 30m。
  6. 交付。 “Soul <name> 已就绪。使用 --soul-id <id> 进行生成。”

使用 Soul

训练完成后，将其传递给 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 会作为模型的 custom_reference_id 发送。要使用精选的 Soul 风格，请使用 higgsfield preset list soul-v2 列出风格，并在 text2image_soul_v2 中将选定的 id 作为 --style_id 传入。--style_id 不能与 --image 一起使用。

列出现有的 Soul

higgsfield soul-id list                   # all references
higgsfield soul-id get <id>               # one by id

错误

  • Minimum Basic plan required — 用户使用的是免费方案；请告知用户。
  • Training failed — 检查照片质量（至少 5 张不同面孔、光线充足）。
  • Session expired → higgsfield auth login。

参考文档

  • references/photo-guide.md — 哪些照片效果最佳
  • references/troubleshooting.md — 常见训练失败问题

评论

支持 Markdown