render_ad
ActiveTool of Hermoso
RECOMMENDED for finished video ADS: render a plan_ad concept through the SAME quality pipeline as the Hermoso web Studio — timed shot list, exact/clean speech (no garbled words), text composited in post (never model-painted), brand end card, licensed music bed, real product references. Pass plan_ad’s full structured output as `creative`. Honors the plan’s render_plan structure/duration: a ≤15s storyboard renders as ONE single-pass clip; a longer plan automatically renders as STITCHED ACTS (fewest balanced ≤15s clips) — never time-compressed into one clip. Renders take 1–3 min; keep polling get_job if it returns still-rendering. Spends credits.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"creative"
],
"properties": {
"model": {
"type": "string",
"description": "video model id from hermoso_capabilities (default: the plan’s pick). Naming one is a DELIBERATE pick — the server asks before ever swapping it (no silent fallback)"
},
"music": {
"type": "boolean",
"description": "licensed music bed on/off (default on)"
},
"dryRun": {
"type": "boolean",
"description": "return the routing decision (single pass vs stitched acts, resolved model + act lengths) WITHOUT submitting a render — free, nothing charged"
},
"lockup": {
"type": "boolean",
"description": "persistent brand-logo lockup overlay on/off"
},
"endCard": {
"type": "boolean",
"description": "branded end card on/off (default: on, except organic recipes)"
},
"captions": {
"type": "boolean",
"description": "composited caption pills on/off (default: the recipe decides)"
},
"creative": {
"type": "object",
"properties": {},
"description": "the FULL structured output of plan_ad (must contain video_storyboard)",
"additionalProperties": {}
},
"ttsVoice": {
"type": "string",
"description": "voiceover voice name (e.g. Rachel / George) when the plan voices over"
},
"resolution": {
"enum": [
"480p",
"720p",
"1080p",
"4k"
],
"type": "string",
"description": "'720p' default; '480p' = cheap fast draft pass, '1080p'/'4k' = premium final delivery (more credits)"
},
"aspectRatio": {
"type": "string",
"description": "output aspect ratio, e.g. 9:16 (default) / 1:1 / 16:9"
},
"durationSeconds": {
"type": "number",
"description": "total ad length in seconds — omit to honor the plan’s own duration"
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Hermoso
https://github.com/hermoso-ai/hermoso
1/7 registries