Happy Horse / v1.1 / referenceToVideo

Happy Horse v1.1's reference-to-video node: feed it reference images plus a prompt, get a video that borrows the look and subject of those references, generated entirely on Civitai's cloud. It's the same idea as the v1.0 version - the pack is Civitai's official Orchestration-API bridge - but with the newer engine and a noticeably wider aspect-ratio menu.

The practical difference you'll feel is in the aspect_ratio dropdown. v1.0 gives you the standard five (16:9, 9:16, 1:1, 4:3, 3:4); v1.1 adds ultrawide 21:9 / 9:21 and near-square 5:4 / 4:5. If you're making cinematic ultrawide content or portrait-orientation shorts that aren't exactly 9:16, this is the node that lets you frame it properly instead of cropping a 16:9 output in post.

How it works

The mechanism is identical to the rest of the pack: assemble a videoGen workflow discriminated to happyHorse / v1.1 / referenceToVideo, POST it to the Civitai Orchestration API, long-poll the job, then download the finished MP4 into ComfyUI's temp folder and return it as a native VIDEO. Your reference images are uploaded with the request - they leave your machine and live on Civitai's servers for the duration of the job. The generation itself is a black box on their fleet; your only job is feeding it good references and a clear prompt.

Inputs and outputs that matter

• prompt (required) - the scene: what happens, camera, style, environment.
• images (required) - an IMAGE socket, plural: wire in one or more reference images. This is what the model anchors character or style to.
• resolution - 720p / 1080p, default 1080p.
• duration - 3–15 seconds, default 5.
• seed - 0 for random; set it to reproduce a take.
• aspect_ratio - the expanded nine: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5.
• api_config - optional auth override.

Outputs: video, workflow_id, raw_json - the pack's standard trio.

Installing it

Shared pack install. ComfyUI Manager → Custom Nodes Manager → "Civitai Comfy Nodes" (publisher civitai) → Install → restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/civitai/civitai-comfy-nodes.git
pip install -r civitai-comfy-nodes/requirements.txt

Just requests; no model downloads.

Common issues

• Auth & Buzz. You need a Civitai account with Buzz. Set CIVITAI_API_TOKEN on headless installs; otherwise connect the Civitai Auth node or store credentials via the sidebar.
• Reference drift is a cloud-model thing. Reference-to-video keeps the style and subject - it won't faithfully clone a specific pose or composition. If you need exact structure, image-to-video (single frame) is usually the better fit.
• Inputs leave the machine. Reference images upload to Civitai. Fine for your own renders, worth a pause for anything confidential.
• Early preview. Nodes and behavior may change without notice; pin the version if a workflow depends on it.
• Cost. Every run bills Buzz, and the wider resolutions aren't cheaper. Check the cost on the node's status line after each run.