Vidu Q3 视频生成
13 models under one roof, from plain text-to-video to 9-image reference work
- image1
- image2
- image3
- image4
- image5
- image6
- image7
- image8
- image9
- api_config
- video
- video_url
- task_id
- response
Vidu_Q3_Video is the general-purpose Vidu Q3 node from T8mars/ComfyUI_Seedance, and "general-purpose" is doing a lot of work: the model dropdown packs in 13 Vidu Q3 variants covering text-to-video, image-to-video, first+last-frame, and reference-to-video generation. One node, one dropdown, four different job types. If you're in the pack for the video side and want a model that isn't Wan or Seedance itself, this is the flexible middle option.
Vidu is closed and Chinese - no weights, no local run, so this is a pure API call through the pack's reseller endpoint (api.seedance.nz), billed per clip. That's the standard contract for every node here: your prompt and images leave the machine, upstream moderation applies, and cost adds up fast on video, so start at 4 seconds and 720p before committing.
How it works
The model value determines the request shape. t2v models use only prompt. i2v models take image1 as the first frame. start-end models use image1 plus image2 as a last frame. r2v models accept up to nine connected images, submitted in slot order. The node handles the upload of local images itself, then submits to the /v1/videos endpoint, polls the task, downloads the result, and hands back a decoded ComfyUI VIDEO. The ratio you pick is forwarded as metadata.ratio and mapped to Vidu's aspectRatio; resolution=default simply leaves the API default in place, which is a sensible starting point.
The prompt field accepts the usual up to 20480 characters, and in the multimodal modes you can reference materials directly in the prompt with @Image 1-style placeholders - handy when you're doing reference work and want to say "make Image 2's character run toward the camera" instead of describing the picture.
Inputs and outputs that matter
model- 13 choices across pro/turbo/fast and t2v/i2v/start-end/r2v.vidu-q3-turbo-t2vis the default; turbo is the cheap-and-cheerful lane.prompt- required for t2v, your editing instruction elsewhere.seconds- 4 to 15, submitted as a string.ratio-adaptive,16:9,4:3,1:1,3:4,9:16,21:9.resolution-default,720p,1080p.seed--1for random; non-negative values are forwarded tometadata.seed, so this is one of the pack's seed-native models.image1–image9- used according to model type.
Outputs: video, video_url, task_id, response - the standard quartet for every video node in this pack.
Install
Same pack, same routine:
# ComfyUI Manager: search "ComfyUI Seedance", or:
comfy node install seedance
Or clone https://github.com/T8mars/ComfyUI_Seedance.git into ComfyUI/custom_nodes, pip install -r requirements.txt, restart ComfyUI, and configure a key from api.seedance.nz/console via the Seedance API Config node (or SEEDANCE_API_KEY).
Where people get burned
The r2v models are the trap. The pack's changelog records that t2v, i2v, and start-end were verified end-to-end with real downloads, but the vidu-q3-r2v family was hitting upstream 502 at submission when tested. Check the release notes before you build a nine-image reference workflow on the r2v path - it may work today, but it's the least battle-tested branch. For everything else, the usual video gotchas apply: keep first runs short, watch the per-call meter, and turn on skip_error if you're batching so one dead frame doesn't sink the queue.
Inputs (17)
| Name | Type | Default | Description |
|---|---|---|---|
| model | COMBO | vidu-q3-turbo-t2v | Vidu Q3 task type. t2v uses prompt; i2v uses image1; start-end uses image1+image2; r2v uses up to 9 images. | Vidu Q3 任务类型:文生、图生、首尾帧、参考生视频。 |
| prompt | STRING | Text prompt, up to 20480 chars. In multimodal mode you can reference materials as @Image 1 / @Video 1 / @Audio 1. | 文本提示词,多模态可用 @Image 1、@Video 1 指代第几个素材。 | |
| seconds | COMBO | 4 | Video duration in seconds, submitted as a string. | 视频时长,按字符串提交。 |
| ratio | COMBO | 16:9 | Aspect ratio forwarded as metadata.ratio for Vidu aspectRatio mapping. | 画幅会通过 metadata.ratio 映射给 Vidu aspectRatio。 |
| resolution | COMBO | default | Optional metadata.resolution; default leaves the API default. | 可选 metadata.resolution;default 使用 API 默认值。 |
| seed | INT | -1-1–2147483647 | -1 = random seed; non-negative values are forwarded to metadata.seed. | -1 表示随机种子,非负整数透传到 metadata.seed。 Fixed reuses the cached result while all inputs stay unchanged; randomize/increment/decrement starts a new execution. | Fixed 在输入不变时复用缓存;随机、递增或递减会触发新任务。 |
| image1opt | IMAGE | Optional Vidu image 1. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 1;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image2opt | IMAGE | Optional Vidu image 2. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 2;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image3opt | IMAGE | Optional Vidu image 3. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 3;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image4opt | IMAGE | Optional Vidu image 4. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 4;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image5opt | IMAGE | Optional Vidu image 5. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 5;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image6opt | IMAGE | Optional Vidu image 6. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 6;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image7opt | IMAGE | Optional Vidu image 7. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 7;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image8opt | IMAGE | Optional Vidu image 8. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 8;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| image9opt | IMAGE | Optional Vidu image 9. i2v uses image1; start-end uses image1+image2; r2v uses connected images in compacted order. | 可选 Vidu 图片 9;i2v 用 image1;首尾帧用 image1+image2;r2v 按已连接图片顺序提交。 | |
| api_configopt | SEEDANCE_CONFIG | Connect Seedance API Config; otherwise SEEDANCE_API_KEY is used. | |
| skip_erroropt | BOOLEAN | false | On failure return a placeholder error video instead of stopping the workflow. | 失败时输出占位错误视频。 |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| video | VIDEO | — |
| video_url | STRING | — |
| task_id | STRING | — |
| response | STRING | — |