Nodes/Comfyui-zhenzhen/Zhenzhen Vidu Image2Video
ComfyUI Node

Zhenzhen Vidu Image2Video

Vidu's image-to-video, with a 300-voice cast

By T8mars·Created about a year ago·Updated 2 days ago· 751
Zhenzhen Vidu Image2Video
  • image
  • video
  • video_url
  • task_id
  • response
◄modelviduq2-pro►
◄prompt►
◄api_key►
◄audiofalse►
◄voice_language中文(普通话)►
◄voice_idmale-qn-jingying►
◄is_recfalse►
◄duration5►
◄seed0►
◄resolution720p►
◄movement_amplitudeauto►
◄bgmfalse►
◄off_peakfalse►
◄watermarkfalse►
◄wm_position3►
◄skip_errorfalse►

Vidu is ByteDance's video model family - the kind of thing that normally lives behind a Chinese consumer app and a login you can't get. Comfly_vidu_img2video is the ComfyUI relay that hands you the API anyway: an image in, a short video out, with the whole menu of Vidu options - duration, resolution, motion amount, BGM, and a voiceover system with three hundred voices - exposed as plain node inputs.

It's part of Comfyui_Comfly, so the ground rules hold: paid relay to ai.comfly.chat, one shared API key, zero local compute. The node base64-encodes your image, POSTs it to the relay's /vidu/v2/img2video endpoint, then polls the task endpoint every 10 seconds until the clip is ready. Expect minutes, not seconds.

Inputs that matter

  • image - the starting frame. This drives everything; Vidu animates what it sees.
  • model - six choices: viduq2-pro, viduq2-turbo, viduq1, viduq1-classic, vidu2.0, vidu1.5. Q2-pro is the current default and the one to reach for first; turbo trades quality for speed.
  • prompt - optional but strongly recommended motion description ("the camera pans right as she walks toward the window").
  • duration - 1–10 seconds (default 5).
  • resolution - 540p/720p/1080p. Higher costs more, and the default 720p is a fine starting point.
  • movement_amplitude - auto/small/medium/large. Small keeps things subtle; large is for dramatic camera moves.

Then the extras that make Vidu distinctive:

  • audio - turn this on to attach a voiceover, then pick voice_language (17 languages, Chinese default) and voice_id (a 300+ entry list of named personas - male-qn-jingying, female-shaonv, and friends).
  • bgm - background music on top.
  • watermark - add a visible watermark; wm_position picks the corner (1–4).
  • off_peak - run during off-peak hours for cheaper/faster processing.
  • is_rec - a Vidu-specific mode toggle; leave off unless you know you need it.
  • seed - reproducibility.

Outputs

video - a VIDEO object that wires straight into ComfyUI's Save Video node. video_url is the hosted link, task_id identifies the job on the relay (where you can also track it), and response is the JSON log, errors included.

Install

cd ComfyUI/custom_nodes
git clone https://github.com/ainewsto/Comfyui_Comfly

or ComfyUI Manager → search "Comfyui_Comfly" → install → restart. API key from ai.comfly.chat into the api_key field.

The honest take

This is the most config-heavy node in the pack, and the menu is genuinely the feature - where else do you get 300 named voices in a ComfyUI dropdown? Just don't touch everything at once. Voice + BGM + watermark + 1080p is a recipe for a slow, pricey job; start with image + prompt + default duration, then add layers. The polling loop is patient (up to ~20 minutes of attempts), so a long wait isn't a hang - it's Vidu. And remember the model family is API-only by ByteDance's design, so this relay is the only way most of you will ever touch it.

Categoryzhenzhen/Vidu

Inputs (17)

NameTypeDefaultDescription
imageIMAGE—
modelCOMBOviduq2-pro6 options: viduq2-pro, viduq2-turbo, viduq1, viduq1-classic, vidu2.0, vidu1.5
promptoptSTRING—
api_keyoptSTRING—
audiooptBOOLEANfalse—
voice_languageoptCOMBO中文(普通话)17 options: 中文(普通话), 中文(粤语), English, 日本語, 한국어, Español, +11
voice_idoptCOMBOmale-qn-jingying303 options: male-qn-qingse, male-qn-jingying, male-qn-badao, male-qn-daxuesheng, female-shaonv, female-yujie, +297
is_recoptBOOLEANfalse—
durationoptINT51–10—
seedoptINT00–2147483647—
resolutionoptCOMBO720p3 options: 540p, 720p, 1080p
movement_amplitudeoptCOMBOauto4 options: auto, small, medium, large
bgmoptBOOLEANfalse—
off_peakoptBOOLEANfalse—
watermarkoptBOOLEANfalse—
wm_positionoptCOMBO34 options: 1, 2, 3, 4
skip_erroroptBOOLEANfalse开启后,节点失败时不报错、按旧行为返回默认空结果;关闭时(默认)失败直接抛出错误。

Outputs (4)

NameTypeDescription
videoVIDEO—
video_urlSTRING—
task_idSTRING—
responseSTRING—