Cloud Save Video
When you just want the MP4 saved to disk, not a VIDEO tensor to mux
- video
- file_path
- prompt_id
Cloud Save Video is the lazy sibling in this pack's video lineup, and lazy is a compliment here. Where Cloud Fetch Video hands you a VIDEO tensor plus a local file path so you can keep processing locally, this node just submits the job, downloads the finished video, writes it into ComfyUI's output directory with a timestamped filename, and hands you back a string path. If your entire plan for the output is "give me the file," this is the one you want - no VIDEO wrapper to trip over.
How it works
It's a terminal node (an output node in ComfyUI terms), which means it fires even when nothing downstream consumes it. It appends a SaveVideo node to the assembled cloud workflow, submits the whole thing to ComfyUI Cloud via /api/prompt, polls until the job finishes, downloads the video, and saves it to ComfyUI's output directory as filename_prefix plus a timestamp. You get back the local path as a STRING and the cloud prompt_id so you can look the job up in the cloud's history later.
The inputs and outputs that matter
- video (CLOUD_VIDEO) - comes from a node that produced a cloud-side encoded video, like Cloud Create Video. A handle, not a tensor.
- filename_prefix (default
cloud_video) - becomes the saved file's name. - format (
autoormp4) -autolets the cloud pick; choosemp4to force MP4. Worth knowing: the final extension is taken from whatever the cloud actually returned, so if you need MP4 specifically, set it rather than trustingauto. - codec (
autoorh264). - poll_interval (default 3s) and timeout (default 1800s, max 7200s) - how often to check the job and how long to wait before giving up.
Outputs: file_path (STRING) and prompt_id (STRING).
Why you'd reach for it
The README is blunt about the timescales here: Wan 2.2 14B image-to-video with the 4-step LoRA finishes in roughly 70–100 seconds, but without the LoRA it can take 8–10 minutes. That's why the default timeout is a generous 1800 seconds - and for the no-LoRA path at higher resolutions, bump it toward the 7200s cap rather than watch the job die at the wire.
Installing it
Install via ComfyUI Manager (search "ComfyUI-CloudAPI-worker") or:
cd ComfyUI/custom_nodes
git clone https://github.com/Dobidop/ComfyUI-CloudAPI-worker
cd ComfyUI-CloudAPI-worker
cp config.json.example config.json
Paste your API key from https://platform.comfy.org/profile/api-keys into config.json and restart ComfyUI. Dependencies are just requests, Pillow and safetensors; there are no model files to download - those all live cloud-side.
Common issues & troubleshooting
- Long job, impatient timeout - raise timeout on this node itself. It's the terminal, so it owns the whole job's timeout.
- Wrong clip landed in your output folder - if the cloud returns more than one video file, the code saves the first and prints a note. Check the console if the file doesn't match what you expected.
- Want to keep muxing locally? Use Cloud Fetch Video instead, which gives you the VIDEO type for things like VHS_VideoCombine. This node deliberately skips that step - it's the "just save it" path.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| video | CLOUD_VIDEO | — | |
| filename_prefix | STRING | cloud_video | — |
| format | COMBO | auto | 2 options: auto, mp4 |
| codec | COMBO | auto | 2 options: auto, h264 |
| poll_interval | FLOAT | 3.00.5–60 | — |
| timeout | INT | 180010–7200 | — |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| file_path | STRING | — |
| prompt_id | STRING | — |