/generating-ad-videos

name: generating-ad-videos
description: Makes a product ad video — a product showcase with no one on screen, or a story or lifestyle commercial where a presenter or actor plays a role in the brand's spot, with or without a voiceover. Use when the user wants a product ad, commercial, TV ad, brand film, or product-hero video. Not for a creator or customer sharing their own take on a product, like a review, unboxing, try-on or testimonial — that is generating-ugc-videos; not for a video with no product being sold — that is generating-videos.
license: Apache-2.0
metadata:
  version: "0.3.0"
  category: creative
  summary: "Produces a polished, cinematic product commercial in your brand's voice — a no-actor product showcase or an actor-led story ad, at any length. It storyboards every clip to hold your real product identical across cuts, writes the voiceover and casts the actor when the ad calls for one, then stitches it into one ready-to-run spot you approve step by step before anything expensive renders."

Product ads

Turn a product into a finished commercial video. One flow, with two optional steps: a voiceover (on by default) and an actor (only where a person is on camera).

Workflow

**The ad runs on `seedance-2.0-fast` unless the user named a model, and is delivered `9:16` unless the user explicitly asked for another ratio.**

Step 1: Read what you have

• **A product image or URL** → hand it to `analyzing-products` for what the product is, how a person physically uses it, which parts open or move, and what must stay identical wherever it appears.
• **Run `image_analysis` on every image supplied**, not only the product — what each one shows, and whatever the product facts leave out.
• **What each image is for comes from the brief, not from its contents.** A person in a frame does not make it the presenter, and a second object does not make it a prop.
• **No product** → don't guess at one. It becomes the first thing Step 2 asks for.

Step 2: Interview

**Skip this when the brief already settles the ad** — a clear product, a clear intent, a length.

Otherwise ask once, bundled into a single message, always with a free-text way out.

| Ask | When | | --- | --- | | **The product** — a link or a photo | Neither was supplied. Offer to wait for an upload; a photographed product beats a described one. | | **How long** | The brief doesn't say. Offer 15s, 30s, 45s or 60s, and let them type their own. | | **Whether a presenter or actor is on camera** | The brief doesn't say whether a person appears in the ad. | | **Whether a voiceover carries it** | The brief doesn't say. The default is yes — a voiceover over the picture; they can pick music and effects only. Any words are always a voiceover, never spoken on camera. |

When the user waives questions, take 15s, no actor, a voiceover on, say in one sentence what you took, and keep going.

Step 3: Write the product description

Write one description and reuse it unchanged in every storyboard — rephrasing it between calls reads as a different product.

• **Material and finish**, surface by surface — matte or gloss, brushed, woven, translucent, or whatever this one actually is: *"brushed steel barrel, matte soft-touch collar, a woven wrist strap"*.
• **Size** — its width and height, and how it sits against a hand: *"sits in a closed palm, roughly 9 cm tall and 4 cm across"*. Give the real measurements rather than likening it to another object, which the model renders inconsistently.
• **Two to five visual anchors** — features you can verify in the product image and nothing else: exact colours, the shape of a closure or handle, the gauge of a chain or strap, a surface finish, a distinguishing mark.
• **The product mechanism** — how it's built and how it works: the parts that move, how they open or close, and where anything dispenses: *"hinged lid at one end, folds back flat; the brush sits inside the cap"*.
• **What may be done with each part** — which parts are fixed to it, and the whole of what the moving ones allow. Nothing later does anything to the product that isn't on this list.

**Don't transcribe what the label says**, even where the product facts spell it out. Spelling out the printing invites the model to redraw it, and redrawn text comes back warped. The facts may name it; the description never repeats it.

Step 4: Plan the concept

Follow the brief exactly wherever it is specific. The rest is yours to decide.

**4a. Read the craft and build the picture.** Read `references/commercial-craft.md` end to end — the angle, the register, the product-identity lock, the shots an ad never uses, the packshot and the sound. It governs every choice from here to the final frame.

**4b. Choose the angle.** Pick the angle the ad sells on, and with it whether anyone is on camera — the common ones, product-only and person-led, are in `references/commercial-craft.md`. Where the brief doesn't fix one, pick the angle that best fits the product — what it is, what it promises, and how it is best shown. The angle leads; the register, the setting and the arc all follow from it.

**4c. Fix the register and the setting.** Pick the register (`references/commercial-craft.md`) and the one setting the product lives in — a surface, a light, a palette — and hold it across the whole ad. With more than one product, decide up front whether each gets its own focus shots through the reel or they are staged together in every shot.

**4d. Decide the presenter.** Only where a person is on camera. Decide the one presenter and hold them across the whole ad, and cast them to fit the ad — the buyer the product is for, the register it's shot in, and the angle it takes: an aspirational spot wants someone the buyer wants to be, a problem-then-product spot someone the buyer recognises as themselves, a high-energy spot someone with the energy the camera chases. Fix their age, look and demeanour now; the wardrobe accent that ties them to the product is set in `r