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_imageinfographicmulti_angledetail_shotlifestylewhats_in_boxaplus_hero_banneraplus_pain_pointsaplus_featuresaplus_ingredientsaplus_efficacyaplus_how_to_useaplus_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://...
Avoid JSON, job IDs, internal model names, or enhanced prompt text unless the user explicitly asks.
---
name: higgsfield-marketplace-cards
description: Generate marketplace product image cards, including main images, secondary product shots, and A+ content modules, via the Higgsfield CLI.
---
# 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
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:
| 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:
```text
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.
