generate_video
ActiveTool of Hermoso
Render a RAW video clip from your own prompt and return its served mp4 URL. For finished brand ADS prefer render_ad (it runs the Studio quality pipeline — composited text, clean speech, end card, music); use this for raw/experimental clips or precise manual control. ONE generation = one continuous clip up to the model’s longest listed duration (seedance-2 goes to 15s single-pass with a full multi-beat arc — never assume a generic 8–10s cap); durationSeconds must be one of the model’s durations from hermoso_capabilities. Renders take 1–3 min. refImage anchors the opening frame; ttsScript adds a voiceover. Pass refVideo (a clip URL) to EDIT an existing video instead of generating from scratch — the omni engine transforms that clip per your prompt, inheriting the source clip’s canvas + length (aspectRatio/durationSeconds are ignored for an edit). Spends credits (Starter plan is video-blocked server-side).
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"model": {
"type": "string",
"description": "video model id from hermoso_capabilities. Naming one is a DELIBERATE pick — the server asks before ever swapping it (no silent fallback); omit it to let the router pick"
},
"prompt": {
"type": "string",
"description": "the video prompt / shot description (for a refVideo edit, this is the transformation instruction)"
},
"refImage": {
"type": "string",
"description": "local path or URL to anchor the first frame"
},
"refVideo": {
"type": "string",
"description": "URL of an existing video to EDIT rather than generate from scratch — the omni engine accepts a raw clip and transforms it per your prompt, inheriting the SOURCE clip’s canvas (aspect ratio) and length (aspectRatio/durationSeconds are ignored for an edit). Omit to generate a fresh clip."
},
"ttsVoice": {
"type": "string",
"description": "voice name, e.g. Rachel / George"
},
"musicMood": {
"type": "string",
"description": "licensed music-bed mood (e.g. upbeat / cinematic) — omit for no music bed"
},
"ttsScript": {
"type": "string",
"description": "voiceover script to speak"
},
"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": "default '9:16'"
},
"durationSeconds": {
"type": "number",
"description": "clip length in seconds"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Hermoso
https://github.com/hermoso-ai/hermoso
1/7 registries