creative_studio_generate_visual
Generate text-free key-visual PNGs for ad creatives, automatically appending a no-text constraint to the prompt. Supports multiple providers, aspect ratios, and layout templates for later text overlay.
Instructions
Generate text-free key-visual PNGs for an ad creative. The prompt describes the imagery ONLY — headline/body/CTA text is added later by the typography layer, so a hard no-text constraint is appended automatically. Images are written to a new run directory with a provenance manifest.json; the tool returns the run id, directory, file paths (with SHA-256), and manifest path. Use 'provider' to pick one configured provider, or 'all' to fan out one image per configured provider.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | Number of candidate images to generate. | |
| aspect | No | Master aspect class; picks the recommended generation size. | square |
| prompt | Yes | Description of the VISUAL only (scene, subject, style, mood). Do not include any copy/text to render. | |
| provider | No | Provider name to use (defaults to the first configured provider). Pass 'all' to generate one image per configured provider. | |
| template | No | Layout template you intend to compose with. When set, a precise negative-space sentence is appended to the prompt so the subject leaves the calm zone that template overlays copy into (hero_overlay -> lower third clear; split -> one half clear; minimal_badge -> even center-weighted texture). Omit to add nothing. |