generate_image
ActiveTool of Hermoso
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.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"model": {
"type": "string",
"description": "image model id from hermoso_capabilities"
},
"prompt": {
"type": "string",
"description": "the full image prompt — subject, composition, lighting, and any on-image ad text"
},
"useBrand": {
"type": "boolean",
"description": "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": {
"type": "string",
"description": "pixel-size preset for models that support it (e.g. 1K/2K) — omit for the default"
},
"refImages": {
"type": "array",
"items": {
"type": "string"
},
"description": "local file paths or URLs of product/logo references to composite in"
},
"aspectRatio": {
"type": "string",
"description": "e.g. '1:1', '9:16', '16:9'"
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Hermoso
https://github.com/hermoso-ai/hermoso
1/7 registries