higgsfield-marketing-studio

# Higgsfield Marketing Studio

## QUICK FACTS
*Generated-checked block (build_index.py verifies anchors). Read the linked sections for full context — these lines are routing aids, not the rules themselves.*
- Hard duration cap: 4–15s per clip; out-of-range values get clamped; longer narrative = multi-clip sequence edited externally [→](#7-generation-parameters)
- 9 presets: UGC, Tutorial, Unboxing (`ugc_unboxing`), Hyper Motion, Product Review, TV Spot, Wild Card, UGC Virtual Try On, Pro Virtual Try On [→](#3-the-9-presets)
- Pro Virtual Try On slug is `virtual_try_on`, NOT `pro_virtual_try_on` [→](#slug-naming-is-canonical-routing-mode-lives-on-a-different-mcp-call)
- Preset routing happens via `show_marketing_studio.mode` — `generate_video` has NO `mode` parameter at all [→](#slug-naming-is-canonical-routing-mode-lives-on-a-different-mcp-call)
- Hook + setting picklists on FIVE presets only: UGC, Tutorial, Unboxing, Product Review, UGC Virtual Try On (NOT Pro Virtual Try On) [→](#4-hook-setting-picklists)
- 9 hooks (4 stunt / 5 subtle) as of 2026-05-18 — picklists drift; enumerate live for current UUIDs [→](#hooks-9-entries-as-of-2026-05-18-visual-scene-templates-not-verbal-copy)
- 14 settings (8 realistic / 6 unrealistic) as of 2026-05-18, passed by UUID as `setting_id` [→](#settings-14-entries-as-of-2026-05-18-environment-templates)
- `avatars` array MUST contain exactly one entry; empty `avatars: []` substitutes a random face per render — always pass one [→](#avatar-field-constraints-consolidated)
- Two-person scenes: primary in `avatars`, secondary as a reference image in `medias` [→](#avatar-field-constraints-consolidated)
- `avatars` and `medias` are top-level siblings of `params` — NOT nested under `params`; wrong nesting rejects [→](#avatars-is-a-separate-top-level-media-slot-not-a-nested-parameter)
- `prompt` is optional; `aspect_ratio` enum: auto/21:9/16:9/4:3/1:1/3:4/9:16; `resolution`: 480p/720p/1080p (default 720p) [→](#7-generation-parameters)
- No `get_cost: true` preflight for MS — verify spend post-hoc via `transactions(limit=200)` [→](#what-is-not-in-the-schema)
- Three MS models exist: `marketing_studio_video` (this skill), `marketing_studio_image`, `ms_image` — call `ms_image` "DTC Ads" with users [→](#three-marketing-studio-models-exist-this-sub-skill-covers-the-video-one)
- Three avatar types: preset (~40 in library), uploaded, text-generated [→](#three-avatar-types)
- TV Spot has a default packshot beat — negate explicitly ("ABSOLUTELY NO PACKSHOT") when unwanted [→](#3-the-9-presets)
- Flowing AND sectioned prompt styles both render — "no section labels" is craft opinion, not an engine constraint; default flowing under 50 words [→](#8-output-prompt-style-flowing-or-sectioned-not-a-hard-rule)
- Cannot do: >15s clips, non-human lip-sync, multi-character dialogue, multi-setting single output, free-form hook/setting IDs, >1 avatar [→](#9-what-marketing-studio-cannot-do)
- Escape hatches when MS can't render it: Wan 2.7, Veo 3.1, Cinema Studio Video 3.0, Seedance 2.0, Kling 3.0 [→](#escape-hatch-models-for-what-ms-cant-render)
- Budget anchor: ~$0.06/credit ≈ ~$9 per video (the more credible of two non-canonical rate samples) [→](#use-the-higher-anchor-for-budget-planning)


Marketing Studio is Higgsfield's opinionated short-form ad-video product. Generations are bounded by a 4–15 second per-clip cap [Phase 0: Probe 0.3-b], routed through one of nine named presets that dictate camera language, register, and the available picklist of hooks and settings. It's distinct from Higgsfield's general video models (Soul, Seedance, Cinema Studio) — those let you write whatever you want; Marketing Studio enforces ad-format conventions per preset and ships with a built-in library of preset hooks, settings, and avatars.

This sub-skill covers Marketing Studio video. The two image-side Marketing Studio surfaces (`marketing_studio_image` and `ms_image` / "DTC Ads") are named in §2 but covered in the companion `cross-surface-workflow.md`.

---

## 1. What Marketing Studio is

Marketing Studio is a routing layer on top of `generate_video` for short-form ad creative. You provide a product image (required) plus optional avatar, location, and additional-asset references. You pick one of nine presets. You optionally write a prompt. Marketing Studio handles the rest — camera language, pacing, hook execution, setting context — per the preset's built-in conventions.

The opinionated thing about Marketing Studio is that the preset choice is load-bearing. Pick `Hyper Motion` and you get kinetic product hero shots with an auto pack-shot at the end [SRT-2:00:13:33]. Pick `TV Spot` and you get composed cinematic narrative — sometimes from a five-word prompt when the asset references carry the weight [SRT-3:00:18:30; PDF items 12, 13]. Pick `Wild Card` and you get permission to break ad-grammar conventions [director:L113–L117; PDF items 10, 11]. The presets aren't decoration; they choose the production rules.

When Marketing Studio isn't the right tool:

- If your video needs to run longer than 15 seconds — Cinema Studio (`higgsfield-cinema`) covers narrative length, or use one of the escape-hatch models in §9
- If you need character-consistent multi-shot video with lip-sync — Wan 2.7 or Veo 3.1 are designed for sync (per §9 escape hatches)
- If you want free-form video without ad framing — Seedance (`higgsfield-seedance`), Soul (`higgsfield-soul`), or Cinema Studio give you the open canvas Marketing Studio's preset routing closes off

---

## 2. Two access surfaces — and three MS models

You reach Marketing Studio two ways:

| Surface | How you reach it | What it exposes |
|---|---|---|
| Web UI at `higgsfield.ai` | Browser, direct | Per-generation controls for preset / aspect ratio / quality / duration / hook / setting / avatar / additional asset [SRT-3:00:09:00–00:10:00]. In-app custom avatar generation by text prompt [SRT-3:00:13:00]. In-app product registration by URL scan [SRT-2:00:08:50] |