Nodes/zhangp365/ComfyUI-utils-nodes/FAL Image2Video Request
ComfyUI Node

FAL Image2Video Request

FAL Image2Video Request

By zhangp365·Created 2 years ago·Updated 5 months ago· 135
FAL Image2Video Request
  • image
  • video
  • width
  • height
  • fps
  • url
prompt
modelfal-ai/wan/v2.2-a14b/image-to-video/turbo
api_key
seed0
resolution720p
aspect_ratioauto
enable_safety_checkerfalse
enable_prompt_expansionfalse
accelerationregular
video_qualityhigh
video_write_modebalanced
end_image_url
timeout300

This is the straightforward one: hand it a still image and a prompt, get a video back. It calls FAL's hosted image-to-video endpoint - defaulting to fal-ai/wan/v2.2-a14b/image-to-video/turbo, the fast-inference variant of Wan 2.2's image-to-video model - so you're animating a reference image without needing the video model loaded locally at all. Wan 2.2 is worth knowing is the open-weight ceiling here: Alibaba never shipped 2.5, 2.6 or 2.7 as downloadable weights, so a hosted "turbo" variant like this is a legitimate way to get Wan-quality i2v without owning the GPU memory a full local Wan 2.2 setup demands.

Inputs that matter: image is your starting frame, required. prompt describes the motion and content you want the video to develop into - this model doesn't just loop the still, it animates forward from it based on what you describe. model is a plain string defaulting to the turbo endpoint above, so you can swap in any other FAL-hosted Wan image-to-video variant by changing this one field. resolution (default 720p, also 480p/580p) and aspect_ratio (default auto, or 16:9/9:16/1:1) set your output framing - auto infers aspect ratio from your input image rather than forcing a crop. acceleration (regular default, or none) and video_quality (low/medium/high/maximum, default high) trade speed against fidelity - this is already the "turbo" model, so acceleration is a second lever on top of that. enable_prompt_expansion (off by default) lets FAL's side expand a short prompt with more detail automatically, useful if you're feeding in terse prompts and want the model to fill in gaps rather than working strictly literally. end_image_url is worth knowing about even if you rarely use it - supplying it targets the generation toward a specific ending frame instead of letting the model animate freely from just the prompt.

Outputs: video, width, height, fps, and a url pointing at the hosted result.

Install: search "ComfyUI-utils-nodes" in ComfyUI Manager, or:

cd ComfyUI/custom_nodes
git clone https://github.com/zhangp365/ComfyUI-utils-nodes

Restart afterward. You need a FAL API key from fal.ai's account settings, passed via the api_key input or a fal_config.yml so it isn't baked into shared workflow files.

Troubleshooting, honestly:

  • enable_safety_checker defaults to false here, which is worth noticing rather than assuming - FAL's default behavior on most of its hosted endpoints is safety checking on; this node ships it off. Flip it on deliberately if that matters for your use case, don't assume it's already filtering content the way a typical hosted API would out of the box.
  • timeout defaults to 300 seconds, which is tight for higher resolutions or the maximum quality setting - video generation at 720p with a slower quality tier can genuinely run past five minutes, and you'll want to raise this (up to 3000) rather than assume something's broken when a request times out.
  • Every call here is billed by FAL. Prototype your prompt and framing at 480p and lower video_quality before committing to a 720p/maximum run - the settings genuinely do change generation time and cost, not just cosmetic output quality.
  • aspect_ratio: auto reads your input image's shape - if your source image has an unusual crop, double-check the output framing matches what you expected rather than assuming it landed on a standard 16:9 or 9:16.
Categoryutils/video

Inputs (14)

NameTypeDefaultDescription
imageIMAGE输入图像
promptSTRING视频描述
modelSTRINGfal-ai/wan/v2.2-a14b/image-to-video/turboFAL模型名称
api_keyoptSTRINGFAL API密钥
seedoptINT00–18446744073709550000随机种子
resolutionoptCOMBO720p视频分辨率
aspect_ratiooptCOMBOauto宽高比
enable_safety_checkeroptBOOLEANfalse启用安全检查
enable_prompt_expansionoptBOOLEANfalse启用提示扩展
accelerationoptCOMBOregular加速模式
video_qualityoptCOMBOhigh视频质量
video_write_modeoptCOMBObalanced视频写入模式
end_image_urloptSTRING结束图像URL
timeoutoptINT3001–3000超时时间(秒)

Outputs (5)

NameTypeDescription
videoVIDEO
widthINT
heightINT
fpsFLOAT
urlSTRING