Higgsfield Ecommerce Ad

Higgsfield E-Commerce Ad Skill

What this skill does

Crafts production-ready e-commerce and DTC advertisement prompts and routes them to the best Higgsfield model for high-converting output. On request, it assembles the full parameter set, surfaces the credit cost, and — after explicit user confirmation — generates the asset via the opt-in generation flow. Text-to-video is the default path; image-to-video is conditional on the user supplying a reference image. Product stills route to ms_image via higgsfield:generate_image.

Model routing

Primary and fallback video models

Routing rule: Use marketing_studio_video by default — it is the dedicated ad pipeline and supports audio generation via generate_audio. Fall back to seedance_2_0 only when (1) the primary model is unavailable, or (2) the user needs genre-tagged output or a video/audio reference role not available on the primary. If falling back, inform the user of the switch. Never switch silently.

MODEL-06 directive: If a parameter is rejected at generation time, call higgsfield:models_explore with the target model name to re-verify the live schema. Full parameter tables: references/model-specs.md.

Per-platform aspect ratio

Quick rule: 9:16 for TikTok Shop / Reels / Shorts; 16:9 for YouTube and Amazon; 1:1 for Instagram feed and Pinterest. Full per-platform table: references/model-specs.md.

Still-image path (DTC Ads — ms_image)

For a product still, hero shot, or mood-board frame before committing to video — or when the user wants a high-quality static DTC product image — route to ms_image via higgsfield:generate_image.

ms_image requires a style_id — this field is REQUIRED and must be provided before generation. brand_kit_id is optional. Resolution options: 1k, 2k, 4k (the 4k enum is a legitimate option for this image model only — it does not apply to any video model in this plan). See full parameter table: references/model-specs.md.

After generating a still with ms_image, the output image can optionally be passed as a start_image reference to marketing_studio_video to carry the composition into video.

Prompt-building workflow

1. Gather intent — Confirm: product category (fashion, beauty, electronics, food, jewelry, home, fitness…), request type (product-only, lifestyle, unboxing, DTC still), target platform, aspect ratio, desired duration, and visual tone.

2. Select model — Apply the routing table above. Choose marketing_studio_video by default; route product-still requests to ms_image via generate_image; select seedance_2_0 only when a routing trigger applies.

3. Build the prompt — Use the craft principles in the references below:

   • Opening 2-second hook from references/hooks.md
   • Product staging, lighting, value communication, lifestyle context from references/ad-craft.md
   • Worked example prompts by product category and platform from references/examples.md

4. Present for review — Show the assembled prompt and all parameters to the user for review and refinement before any generation call.

Opt-in generation

Generation costs Higgsfield credits and requires explicit user confirmation before any generate call is made. This skill never auto-generates.

Full step-by-step flow (confirmation gate, balance/cost surface, generate → poll → display): ../../shared/generation-flow.md

This skill's primary model: marketing_studio_video

Audio: marketing_studio_video supports a generate_audio boolean. Surface this option to the user — enabling it may affect credit cost.

Media upload: Conditional — only when the user supplies a start_image, end_image, or other reference for image-to-video. This skill is NOT a mandatory-I2V skill; T2V is the default path. When a reference is provided, run the higgsfield:media_upload → higgsfield:media_confirm atomic pair first.

Tool signatures: ../../shared/mcp-tools.md

Reference materials