Higgsfield ソウルキャラクター

Higgsfield ソウルキャラクター は何をしますか？

顔に忠実なアイデンティティモデルをトレーニングします。全てのソウル対応生成で再利用可能です。

ステップ 0 — 初期設定

他のコマンドを実行する前に:

1. higgsfield が $PATH 上にない場合は、インストールします:

   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. ソウルトレーニングには有料プラン（Basic+）が必要です。higgsfield account status で無料プランが表示された場合は、送信前にユーザーに伝えてください。

UX ルール

1. 簡潔にしてください。チャット内で生の ID は表示しないでください。「ソウル準備完了」と名前を参照して伝えるだけにしてください。
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>。非表示。デフォルトのタイムアウトは 30 分です。
6. 結果を伝える。 「ソウル <name> の準備ができました。生成時に --soul-id <id> を使用してください。」

ソウルを使用する

トレーニング後、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

既存のソウルを一覧表示する

higgsfield soul-id list                   # 全ての参照
higgsfield soul-id get <id>               # ID で1つ取得

エラー

• Minimum Basic plan required — ユーザーは無料プランです。伝えてください。
• Training failed — 写真の品質を確認してください（5枚以上のユニークな顔、明るい照明）。
• Session expired → higgsfield auth login。

参考ドキュメント

• references/photo-guide.md — 最適な写真の選び方
• references/troubleshooting.md — よくあるトレーニングの失敗