ビデオメーカースタジオ / Marketplace Cards

マーケットプレイスカード

higgsfield marketplace-cards create を使用して、マーケットプレイスにそのまま使える商品ビジュアルを作成します。 CLI は最初にバックエンドエンハンサーを呼び出します（ここでマーケットプレイスのルールとテンプレートが非公開で管理されます）。次に nano_banana_2 ジョブを作成し、結果のURLを出力します。

ブートストラップ

1. higgsfield が $PATH にない場合、公式インストーラを Bash で実行してインストールします: curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
2. higgsfield account status が認証エラーで失敗した場合、ユーザーに higgsfield auth login を実行するよう依頼します。

UX ルール

1. ユーザーの言語で応答します。
2. 実行前に、確認の質問は1つだけ簡潔に行います。
3. 商品画像を優先します。ユーザーがテキストまたはURLのみを提供した場合は、商品詳細が明確な場合にのみ進めます。
4. 最終的な画像生成プロンプトを自分で書かないでください。バックエンドエンハンサーが担当します。
5. 最終的な回答には、完成した画像のURLと短いラベルのみを含めます。

スコープの選択

ユーザーが一般的なバンドルをリクエストした場合は --scope を使用します：

スコープ	生成内容
main	マーケットプレイスメイン画像1枚
product-images	メイン画像 + セカンダリ画像5枚
aplus	メイン画像 + A+モジュール7個
full-set	メイン画像 + セカンダリ画像5枚 + A+モジュール7個

カスタムサブセットの場合は --asset を繰り返し使用します：

• main_image
• infographic
• multi_angle
• detail_shot
• lifestyle
• whats_in_box
• aplus_hero_banner
• aplus_pain_points
• aplus_features
• aplus_ingredients
• aplus_efficacy
• aplus_how_to_use
• aplus_endorsement

コマンド

ユーザーのリクエストから1つの higgsfield marketplace-cards create コマンドを作成して実行します。

一般的なバンドルには --scope <main|product-images|aplus|full-set>、--prompt "<短い商品と出品の意図>"、オプションで繰り返しの --image <パスまたはアップロードID>、およびコンテキストフラグ --product_context、--brand_context、--category、--visual_style を使用します。

引数を選択する際の参考例：

• 商品画像：higgsfield marketplace-cards create --scope product-images --prompt "スパークリングピーチレモネード缶、マーケットプレイス出品用" --image ./can.png --category "beverage"
• フルセット：higgsfield marketplace-cards create --scope full-set --prompt "プレミアムスキンケアセラム、クリーンクリニカルマーケットプレイスビジュアルシステム" --image ./serum.jpg --brand_context "ミニマルな白とセージグリーンパレット"
• カスタムサブセット：--asset を繰り返し使用します。例：--asset main_image --asset infographic --asset lifestyle
• 既存の完了済みメイン画像ジョブ：リクエストされたセカンダリまたはA+の --asset 値とともに --main-job <完了済みメインジョブID> を使用します。

納品

ラベル付きでURLを出力します：

マーケットプレイスカード準備完了：
- メイン画像：https://...
- インフォグラフィック：https://...
- ライフスタイル：https://...

ユーザーが明示的に要求しない限り、JSON、ジョブID、内部モデル名、拡張プロンプトテキストは避けてください。