mcpField
H
higgsfield-soul-id

higgsfield-soul-id

github.com/higgsfield-aiクリエイティブ・メディア1.8k198.7k 回インストール1 日前に更新
リポジトリ

higgsfield-soul-id について

higgsfield-soul-idは、Higgsfield CLIで顔の特徴を保つ再利用可能なIDモデルを作成するワークフロースキルです。写真の送信、バリアント選択、トレーニング、生成時のSoul参照の利用を案内します。

主な機能

  1. 01写真からSoul IDを作成
  2. 02画像用またはシネマティック用を選択
  3. 03トレーニング完了まで待機
  4. 04既存Soulの一覧表示と取得
  5. 05生成時にSoul参照を利用

活用シーン

  1. 01画像生成用の再利用可能なIDの準備
  2. 02シネマティック作品や動画用IDの作成
  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 Character

顔の忠実度を保ったアイデンティティモデルをトレーニングします。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. 名前を確認します。 後で参照するための 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 がパスを自動でアップロードします。返された参照 ID を取得します。
  5. 待機します。 higgsfield soul-id wait <id>。待機中は何も伝えません。デフォルトのタイムアウトは 30m です。
  6. 完了を伝えます。 「Soul <name> の準備ができました。--soul-id <id> を指定して generate で使用できます。」

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 でスタイルを一覧表示し、選んだ ID を text2image_soul_v2 の --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 対応