Higgsfield ソウルキャラクター

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

顔に忠実なアイデンティティモデルをトレーニングします。すべての Soul 搭載生成で再利用可能です。

ステップ 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. Soul トレーニングには有料プラン（Basic+）が必要です。higgsfield account status が無料プランを示している場合は、送信前にユーザーに伝えてください。

UX ルール

1. 簡潔に。チャット内で生の ID を表示しない。「Soul ready」と名前の参照のみ伝えてください。
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. 結果を伝えます。 「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 を一覧表示

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 — よくあるトレーニング障害