商品撮影
higgsfield product-photoshoot create コマンドを介したブランド画像生成。CLIは、モード固有の写真用語と構造テンプレートを保持するバックエンドプロンプト拡張エンジンを呼び出し、gpt_image_2 に送信して画像URLを返します。
ステップ0 — ブートストラップ
他のコマンドの前に:
higgsfieldが$PATHにない場合はインストールします:curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | shhiggsfield 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、3:2、9:16、16:9。
解像度
すべての商品撮影ジョブで 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-generateMarketing Studio を置き換えません。 - 商品やブランドコンテキストのない生のテキストから画像への
higgsfield-generateを置き換えません。
避けるべき一般的な間違い
- 1つのメッセージで4つ以上のインタビュー質問をすること。
- 間違ったモードを選択すること (例:ユーザーがPinterestピンを望んでいるのに
product_shotを選択)。 higgsfield product-photoshoot createの代わりにhiggsfield generate create gpt_image_2 --prompt ...を直接呼び出すこと — プロンプト拡張エンジンをバイパスし、著しく品質の低い出力を生成します。- 組み立てられたプロンプトをユーザーに貼り付けること — ユーザーはURLを望んでいます。
- 上記テーブルにない
--mode値を使用すること。