商品撮影（Product Photoshoot）

higgsfield product-photoshoot create コマンドによるブランド画像生成。CLIはモード固有の写真用語と構造テンプレートを保持するバックエンドのプロンプト拡張エンジンを呼び出し、gpt_image_2 に送信して画像URLを返します。

ステップ 0 — ブートストラップ

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

$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（対話型）を実行し、確認を待つよう依頼します。

UXルール

簡潔に。最終的な返信には画像URLのみを表示します。
言語を検出し、その言語で応答します。モード名とCLIフラグは英語のままです。
送信前に最大4つの短い質問をします。ラベル付きオプションを使用し、自由記述は避けます。
文脈（アップロードされた画像、以前のターン、ブランドメモリ）から明らかな質問はスキップします。
gpt_image_2 のプロンプトを自分で作成してはいけません。バックエンドが組み立てます。
ポーリングは非同期で行います。URLの準備ができるまで待ち、その後配信します。

モード

モード	ユーザーが求めるもの…
`product_shot`	ニュートラル / スタジオ / カタログ背景の商品
`lifestyle_scene`	実環境、手、アクション、雰囲気の中の商品
`closeup_product_with_person`	手 / 顔の一部をタイトに捉えたクロップ — 美容適用、保持、デモンストレーション
`moodboard_pin`	縦長の2:3 Pinterestネイティブな美学、ムードボード感覚
`hero_banner`	ワイドフォーマットのウェブサイト / メール / キャンペーンヘッダー
`social_carousel`	IG / LinkedIn / Facebook 向けの3～10枚の連結スライド
`ad_creative_pack`	Meta / TikTok / Pinterest / Google Ads 向けの静的な広告バリエーションの調整パック
`virtual_model_tryout`	AIレンダリングモデルが着用または使用する商品
`conceptual_product`	シュール / CGIスタイル / 浮遊 / スプラッシュ / 彫刻的な商品
`restyle`	既存画像の美学、ムード、季節的文脈を変換

モード選択

表面のキーワードではなく意図で選びます。2つのモードが適用可能な場合は、より具体的な方を優先します。

商品 + ニュートラル / クリーン / 白 / スタジオ / カタログ / Shopify → product_shot
商品 + シーン / 使用中 / キッチン / 屋外 / カフェ / ジム → lifestyle_scene
手で保持 / 顔と商品 / 美容適用 / デモンストレーション → closeup_product_with_person
Pinterest、ピン、縦長ピン → moodboard_pin
ヒーロー、バナー、ウェブサイトヘッダー、ランディングページ、メールヘッダー、ワイドフォーマット → hero_banner
カルーセル、スライド投稿、マルチスライド、スワイプ可能 → social_carousel
広告、広告パック、有料ソーシャル、Meta / TikTok / Pinterest広告 → ad_creative_pack
モデル着用、バーチャル試着、ボディオン、ファッションシュート、ルックブック → virtual_model_tryout
浮遊、フローティング、スプラッシュ、フリーズモーション、シュール、CGI、彫刻的 → conceptual_product
既存画像の美学、ムード、季節を変更 — 被写体は変更しない → restyle

タイブレーカー：

"キッチンカウンターにある私の商品のPinterestピン" → moodboard_pin（Pinterestがプラットフォーム）
"私の商品を使用中のヒーローバナー" → hero_banner（バナーフォーマットが優先）
"さまざまなシーンの私の商品のカルーセル" → social_carousel（マルチスライドが優先）
"私の美容液を塗っている人のクローズアップ" → closeup_product_with_person（特定のジャンルが優先）

生成前インタビュー

送信前に3～4つの短い質問をします。常にラベル付きオプション、自由記述は禁止。文脈から明らかな質問はスキップします。

タイプA — 商品写真をアップロード、「画像 / 撮影を作って」

何枚？ [1 / 3 / 5]
スタイル / ムードは？ [クリーンスタジオ / ライフスタイル / コンセプチュアル / モデルあり / その他]
どこで使用しますか？ [Shopify / Instagram / Pinterest / 有料広告 / ウェブサイトヒーロー]
合わせるブランドカラーは？（明らかな場合はスキップ）

タイプB — 商品写真をアップロード、ユースケースを指定

例：「商品の広告を作って」「Pinterestピンを作って」「ヒーローバナーを作って」。モードは明らか。不足分のみ質問：

何枚？（マルチ出力モードの場合）
提供内容 / ムード / フックは？
特に強調する点は？

タイプC — テキストのみ、商品写真なし

商品写真をアップロードできますか？（推奨 — はるかに高品質）
できない場合、商品を説明してください — カテゴリー、パッケージ、色、特徴。
スタイルは？（タイプAと同じオプション）
どこで使用しますか？

タイプD — 既存画像をアップロード、「リメイク / 雰囲気変更 / 別バージョン」

→ restyle

美学？ [クリーンガール / コテージコア / 静かな贅沢 / ダークアカデミア / Y2K / その他]
季節的文脈？ [クリスマス / バレンタイン / ハロウィン / ブラックフライデー / なし]
何を保持し、何を変更する？（あいまいな場合のみ）

タイプE — モデルが商品を着用（ファッション、アクセサリー）

→ virtual_model_tryout

モデルアーキタイプ？（ブランドオーディエンスに基づいて2～3提案）
環境？ [スタジオクリーン / 屋外ナチュラル / ストリートスタイル / エディトリアル / ホームコージー]
フレーミング？ [フルボディ / 四部身 / ウエストアップ / 商品エリアのクローズアップ]

タイプF — あいまいなリクエスト、不明瞭な被写体

例：「ブランドのクールなものを作って」。

商品やトピックは？
目的？ [マーケットプレイスで販売 / 認知度向上 / 有料広告運用 / ウェブサイト更新]
参考画像をアップロードしますか？

回答後 → 該当するタイプA～Eに戻ります。

生成

単一コマンド。バックエンドが最終プロンプトを組み立て、gpt_image_2 に送信します。URLは標準出力に出力されます。

higgsfield product-photoshoot create \
  --mode <モード> \
  --prompt "<インタビュー回答からの短いユーザー意図説明>" \
  [--image <パスまたはアップロードID>]... \
  [--count <1-10>] \
  [--aspect_ratio <オーバーライド>]

例：

higgsfield product-photoshoot create \
  --mode lifestyle_scene \
  --prompt "日差しの入るキッチンカウンターにあるコールドブリューのボトル、IGフィード" \
  --image bottle.jpg \
  --count 3

higgsfield product-photoshoot create \
  --mode moodboard_pin \
  --prompt "キャンドルブランドの縦型ピン、コテージコアムード" \
  --image candle.jpg

higgsfield product-photoshoot create \
  --mode restyle \
  --prompt "クリスマスバージョン、静かな贅沢の美学" \
  --image existing-shot.jpg

画像入力

--image はローカルファイルパス（自動アップロード）または既存のアップロードUUIDを受け入れます。複数の参照用にフラグを繰り返します。

マルチバリアント

--count 3 は3つの異なる画像URLを返します。バックエンドはバリアント全体でプリセット、照明、角度、パレットを変化させるよう拡張エンジンに依頼します。これらは互いの言い換えコピーにはなりません。

social_carousel および ad_creative_pack の場合、count = パック内のスライド/バリアントの数です。バックエンドは全スライドのビジュアルシステムを自動的に固定します。

アスペクト比

バックエンドはモードごとに適切なデフォルトを選択します。ユーザーが明示的に異なるものを要求した場合のみ --aspect_ratio でオーバーライドします。許可値：1:1、4:5、5:4、3:4、4:3、2:3、9:16、16:9。

解像度

すべてのproduct-photoshootジョブには 2k を使用します。

結果の配信

画像URLを短い箇条書きリストで表示します。JSON、ID、内部モデル名、拡張プロンプトテキストは含めません。ジョブが失敗した場合は、失敗ステータスとともに簡単に言及します。

3枚のライフスタイルショット準備完了：
- https://cdn.higgsfield.ai/.../job_abc.jpg
- https://cdn.higgsfield.ai/.../job_def.jpg
- https://cdn.higgsfield.ai/.../job_ghi.jpg

このスキルが行わないこと

gpt_image_2 プロンプトを直接作成しません。バックエンドがプロンプト組み立てを担当します。
別の画像生成モデルを自動選択しません。常に gpt_image_2 です。
ブランド化されたビデオ/アバターワークフローのための higgsfield-generate Marketing Studio を置き換えません。
商品やブランドのコンテキストがないテキストから画像への生の生成には higgsfield-generate を置き換えません。

避けるべき一般的な間違い

1回のメッセージで4つ以上のインタビュー質問をすること。
間違ったモードを選択すること（例：ユーザーがPinterestピンを求めているのに product_shot を選択）。
higgsfield product-photoshoot create の代わりに直接 higgsfield generate create gpt_image_2 --prompt ... を呼び出す — プロンプト拡張をバイパスし、著しく品質が低下します。
組み立てられたプロンプトをユーザーに貼り付けること — ユーザーはURLを求めています。
上記の表にない --mode 値を使用すること。

adamroy13/ai-influencer-promo-machine

ai-influencer-promo-machine とは？

お気に入りのAIに質問する

ドキュメント