Generate ad image
generate_imageRender ad images with product-accurate compositing using refImages. Supports brand hydration and custom prompts for multi-brand use.
Instructions
Render a finished ad IMAGE and return its served URL. refImages (local paths or URLs) force product-accurate compositing (drops a real product into the scene). MULTI-BRAND CAUTION: useBrand hydration pulls the SAVED workspace brand — when working a brand that is NOT the saved one (a fresh draft_brand), pass that brand's own productImages/logo as refImages (and useBrand:false) or the output composites the WRONG brand's product. model = a catalog id from hermoso_capabilities (omit for the default). Fast (seconds). Spends credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | image model id from hermoso_capabilities | |
| prompt | Yes | the full image prompt — subject, composition, lighting, and any on-image ad text | |
| useBrand | No | default true: with no refImages, the server hydrates the SAVED brand’s product/logo references so the output lands on-brand; pass false for a pure prompt-only render | |
| imageSize | No | pixel-size preset for models that support it (e.g. 1K/2K) — omit for the default | |
| refImages | No | local file paths or URLs of product/logo references to composite in | |
| aspectRatio | No | e.g. '1:1', '9:16', '16:9' |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | No | the served absolute URL of the finished image | |
| model | No | the product-facing label of the model that rendered it |