Plan an ad concept
plan_adTake a brand and product brief, and produce a complete ad concept with copy variants and a visual prompt for image or video generation.
Instructions
Creative director: turn a brand + product/brief into a finished ad CONCEPT — copy variants (headline/primary/cta) plus an image_concept.prompt OR a video_storyboard, with the resolved recipe + the model ids to render with. Renders nothing; chain its output into generate_image / generate_video. Spends LLM tokens, 0 ScrapeCreators credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | brand name, or a brand profile object {name,domain,category,palette,products,…}. OMIT to use the workspace’s SAVED brand + memory automatically (see get_brand); use draft_brand to onboard a new one | |
| format | No | 'image', 'video', or 'auto' when unspecified | |
| recipe | No | a recipe id from hermoso_capabilities to force an archetype | |
| product | Yes | what to advertise + any angle/offer the user specified | |
| language | No | output language for the ad copy (e.g. Spanish) — default English | |
| reference | No | a reference ad URL to remix the angle from — Facebook Ad Library, LinkedIn Ad Library or Google Ads Transparency links (the real ad’s copy/advertiser are fetched and fed into the concept) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| copy | No | copy variants ({headline, primary, cta}) | |
| brand | No | the brand grounding embedded in the creative (name, logo, palette, productImages) | |
| format | No | the resolved creative format — 'image' or 'video' | |
| imodel | No | the image model id to render with | |
| recipe | No | the resolved recipe id | |
| vmodel | No | the video model id to render with | |
| concept | No | the one-line creative concept | |
| render_plan | No | the routing plan (structure/duration) render_ad honors | |
| recipe_label | No | the resolved recipe display name | |
| image_concept | No | the render-ready image concept (prompt etc.) when format is image | |
| video_storyboard | No | the timed storyboard (scenes, cta, music) when format is video |