Marketplace Cards

Create marketplace-ready product visuals with higgsfield marketplace-cards create. The CLI first calls the backend enhancer, where marketplace rules and templates are kept private, then creates nanobanana2 jobs and prints result URLs.

Bootstrap

1. If higgsfield is not on $PATH, install it by running the official installer with Bash: curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh.
2. If higgsfield account status fails with authentication errors, ask the user to run higgsfield auth login.

UX Rules

1. Respond in the user's language.
2. Ask at most one concise confirmation question before running.
3. Prefer a product image. If the user provides only text or a URL, proceed only when the product details are clear.
4. Do not write final image-generation prompts yourself. Backend enhancement owns that.
5. Final answer should contain only the ready image URLs and short labels.

Scope Selection

Use --scope when the user asks for a common bundle:

Use repeated --asset only for custom subsets:

• main_image
• infographic
• multi_angle
• detail_shot
• lifestyle
• whatsinbox
• aplusherobanner
• apluspainpoints
• aplus_features
• aplus_ingredients
• aplus_efficacy
• aplushowto_use
• aplus_endorsement

Command

Build and run one higgsfield marketplace-cards create command from the user's request.

For common bundles, use --scope <main|product-images|aplus|full-set>, --prompt "<short product and listing intent>", optional repeated --image <path-or-upload-id>, and optional context flags: --productcontext, --brandcontext, --category, --visual_style.

Examples to mirror when choosing arguments:

• Product images: higgsfield marketplace-cards create --scope product-images --prompt "sparkling peach lemonade can for marketplace listing" --image ./can.png --category "beverage"
• Full set: higgsfield marketplace-cards create --scope full-set --prompt "premium skincare serum, clean clinical marketplace visual system" --image ./serum.jpg --brand_context "minimal white and sage palette"
• Custom subset: repeat --asset, for example --asset main_image --asset infographic --asset lifestyle.
• Existing completed main image job: use --main-job <completedmainjob_id> with the requested secondary or A+ --asset values.

Delivery

Print URLs with labels:

Marketplace cards ready:
- Main image: https://...
- Infographic: https://...
- Lifestyle: https://...

Avoid JSON, job IDs, internal model names, or enhanced prompt text unless the user explicitly asks.