higgsfield-product-photoshoot

商品のフォトシュート

higgsfield product-photoshoot create コマンドを使ってブランドイメージを生成します。CLI は、モードごとの写真撮影用語と構成テンプレートを備えたバックエンドのプロンプト拡張機能を呼び出し、その後 gpt_image_2 に送信して画像 URL を返します。

ステップ 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 を実行するよう依頼し（対話形式）、確認を待ちます。

UX ルール

1. 簡潔にします。最終返信には画像 URL のみを表示します。
2. 言語を検出し、その言語で応答します。モード名と CLI フラグは英語のままにします。
3. 送信前に質問できるのは最大 4 つまでです。ラベル付きの選択肢を使い、自由回答形式にはしないでください。
4. アップロード画像、過去のやりとり、ブランド情報などから答えが明らかな質問は省略します。
5. gpt_image_2 のプロンプトを自分で作成しないでください。バックエンドが組み立てます。
6. ポーリング中は何も表示しません。URL の準備ができたら、結果を提示します。

モード

モード	ユーザーが希望する内容
product_shot	ニュートラル／スタジオ／カタログ向けの背景に商品を配置
lifestyle_scene	実際の環境、手、動き、雰囲気の中に商品を配置
closeup_product_with_person	手や顔の一部を含むクローズアップ — ビューティー商品の使用、持つ様子、実演
moodboard_pin	縦型 2:3 の Pinterest 向けデザイン、ムードボード風
hero_banner	ウェブサイト／メール／キャンペーンのヘッダー向け横長フォーマット
social_carousel	連続する 3～10 枚のスライド。IG／LinkedIn／Facebook 向け
ad_creative_pack	Meta／TikTok／Pinterest／Google Ads 向けの、統一感のある静止画広告バリエーション一式
virtual_model_tryout	AI 生成モデルが商品を着用または使用
conceptual_product	シュール／CGI 風／浮遊／飛沫／彫刻的な商品表現
restyle	既存画像の美的表現、雰囲気、季節感を変更

モードの選択

表面的なキーワードではなく、意図に基づいて選びます。複数のモードが当てはまる場合は、より具体的なものを優先します。

• 商品 + ニュートラル／すっきり／白／スタジオ／カタログ／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. 何枚にしますか？ [1 / 3 / 5]
2. どのようなスタイル／雰囲気にしますか？ [すっきりしたスタジオ / ライフスタイル / コンセプチュアル / モデルあり / その他]
3. どこで使用しますか？ [Shopify / Instagram / Pinterest / 有料広告 / ウェブサイトのヒーロー]
4. 合わせるブランドカラーはありますか？（明らかな場合は省略）

タイプ B — 商品写真をアップロードし、用途を指定した場合

例：「商品の広告を作って」「Pinterest のピンを作って」「ヒーローバナーを作って」。モードは明らかです。不足している情報だけを尋ねます。

1. いくつ必要ですか？（複数出力モードの場合）
2. オファー／雰囲気／フックは何ですか？
3. 特に強調したいことはありますか？

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

1. 商品写真をアップロードできますか？（推奨 — はるかに忠実な仕上がりになります）
2. 難しい場合は、商品について説明してください — カテゴリ、パッケージ、色、特徴的な要素。
3. どのようなスタイルにしますか？（タイプ A と同じ選択肢）
4. どこで使用しますか？

タイプ D — 既存の画像をアップロードし、「作り直す／雰囲気を変える／別バージョン」と依頼した場合

→ restyle

1. どのような美的スタイルにしますか？ [Clean girl / Cottagecore / Quiet luxury / Dark academia / Y2K / Other]
2. 季節やイベントの指定はありますか？ [Christmas / Valentine's / Halloween / Black Friday / None]
3. 残すもの、変更するものは何ですか？（曖昧な場合のみ）

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

→ virtual_model_tryout

1. モデルのタイプは？（ブランドのターゲット層に基づいて 2～3 種類を提案します）
2. 環境は？ [Studio clean / Outdoor natural / Street style / Editorial / Home cozy]
3. 構図は？ [Full body / Three-quarter / Waist up / Closeup on product area]

タイプ F — 依頼が曖昧で、対象が不明な場合

例：「ブランド向けに何かかっこいいものを作って」。

1. 商品またはテーマは何ですか？
2. 目的は？ [Sell on a marketplace / Build awareness / Run paid ads / Update website]
3. 参考画像をアップロードしますか？

回答を受けたら → 該当するタイプ A～E に戻ります。

生成

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

higgsfield product-photoshoot create \
  --mode <mode> \
  --prompt "<short user-intent description from interview answers>" \
  [--image <path-or-upload-id>]... \
  [--count <1-10>] \
  [--aspect_ratio <override>]

例：

higgsfield product-photoshoot create \
  --mode lifestyle_scene \
  --prompt "bottle of cold-brew on a sunlit kitchen counter, IG feed" \
  --image bottle.jpg \
  --count 3

higgsfield product-photoshoot create \
  --mode moodboard_pin \
  --prompt "vertical pin for my candle brand, cottagecore mood" \
  --image candle.jpg

higgsfield product-photoshoot create \
  --mode restyle \
  --prompt "Christmas version, quiet-luxury aesthetic" \
  --image existing-shot.jpg

画像入力

--image には、ローカルファイルのパス（自動的にアップロードされます）または既存のアップロード UUID を指定できます。複数の参考画像を指定する場合は、このフラグを繰り返してください。

複数バリエーション

--count 3 を指定すると、異なる画像 URL が 3 つ返されます。バックエンドはエンハンサーに指示して、バリエーションごとにプリセット、ライティング、角度、配色を変えるため、同じ内容を言い換えただけの画像にはなりません。

social_carousel と ad_creative_pack では、count はパック内のスライド／バリエーションの数です。バックエンドがすべてのスライドでビジュアルシステムを自動的に統一します。

アスペクト比

バックエンドはモードごとに適切なデフォルトを選びます。ユーザーが別の比率を明示的に希望した場合に限り、--aspect_ratio で上書きしてください。使用できる値：1:1、4:5、5:4、3:4、4:3、2:3、3:2、9:16、16:9。

解像度

商品撮影のジョブでは、すべて 2k を使用してください。

結果の提示

画像 URL を短い箇条書きで表示してください。JSON、ID、内部モデル名、強化後のプロンプト文は表示しないでください。ジョブが失敗した場合は、失敗ステータスとともに簡潔に伝えてください。

3 lifestyle shots ready:
- 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 に指定する。