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 nano_banana_2 jobs and prints result URLs.

Bootstrap

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.
If higgsfield account status fails with authentication errors, ask the user to run higgsfield auth login.

UX Rules

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

Scope Selection

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

Scope	Creates
`main`	1 marketplace main image
`product-images`	main image + 5 secondary images
`aplus`	main image + 7 A+ modules
`full-set`	main image + 5 secondary images + 7 A+ modules

Use repeated --asset only for custom subsets:

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

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: --product_context, --brand_context, --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 <completed_main_job_id> with the requested secondary or A+ --asset values.

Delivery

Print URLs with labels:

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