Nodes/ComfyUI Seedance/Vidu Q3 短剧成片
ComfyUI Node

Vidu Q3 短剧成片

Script in, finished drama clip out — if the upstream is feeling generous

By T8mars·Created 2 months ago·Updated 3 days ago· 31
Vidu Q3 短剧成片
  • asset_image1
  • asset_image2
  • asset_image3
  • asset_image4
  • asset_image5
  • asset_image6
  • asset_image7
  • asset_image8
  • asset_image9
  • asset_image10
  • asset_image11
  • asset_image12
  • asset_image13
  • asset_image14
  • api_config
  • video
  • video_url
  • task_id
  • response
modelvidu-q3-drama-short-play
prompt
script_nameVidu short play
resolution1080p
duration8
aspect_ratio9:16
stylerealistic
asset_typecharacter
asset_name_prefixAsset
asset_descriptionReference asset
skip_errorfalse
seed0

Most video nodes ask you to write a prompt. Vidu_Q3_ShortPlay asks you to write a script. It's the "短剧成片" node - short-drama finishing - and it takes a script, a cast of character/scene/prop reference images, and turns them into a finished short-form clip, which is a whole different job from a one-shot text-to-video generation. You hand it a story and assets; it hands back a produced take.

Vidu is a closed Chinese video model, so there's no local option at any VRAM - an API wrapper is the only door, and this one routes through the pack's reseller endpoint (api.seedance.nz). That framing matters twice here: you're paying per clip through a third party, and you're also at the mercy of the upstream's availability, which for this specific node has been shaky (more below).

How it works

Pick one of the two models - vidu-q3-drama-short-play or vidu-q3-ad-short-play (drama vs. ad) - and the node assembles the request. Your prompt is the script content, forwarded as the script; script_name goes into metadata.script_name. The reference images you connect (asset_image1 through asset_image14) get uploaded and labeled as assets, with the asset_type (character, scene, or prop), asset_name_prefix, and asset_description fields deciding how each one is described to the model. That's the mechanism worth understanding: this isn't img2img with a single first frame, it's "here are my characters and locations, now act out this script." At least asset_image1 is required - the node is strict about that.

Resolution is locked to 1080p (the API requires it), duration is 812 seconds, aspect is 9:16 or 16:9 (you want 9:16 for short-drama, that's the format), and style caps at 30 characters.

Inputs and outputs that matter

  • prompt - the script. This is the creative input.
  • script_name - a name for the piece, passed through as metadata.script_name.
  • model - drama or ad short-play.
  • duration, aspect_ratio, style, resolution (fixed 1080p).
  • asset_image1asset_image14 - reference character/scene/prop images, labeled via asset_type, asset_name_prefix, asset_description.

Outputs are the standard video quartet: video (downloaded and decoded to ComfyUI VIDEO), video_url, task_id, and response.

Install

This is one node in the T8mars/ComfyUI_Seedance pack, so install the pack once:

# ComfyUI Manager: search "ComfyUI Seedance", or:
comfy node install seedance

Or git clone https://github.com/T8mars/ComfyUI_Seedance.git into ComfyUI/custom_nodes and pip install -r requirements.txt (just requests). You'll need an API key from api.seedance.nz/console, provided via the Seedance API Config node, the SEEDANCE_API_KEY env var, or a config/.env file.

The honest caveat

The pack's own changelog (v0.2.3) says both short-play models were returning an upstream 502 invalid_upstream_response at the submission stage when the node was tested - a Vidu-side problem, not a config error on your part. The example workflow exists and the node is fully wired, but this is the one node in the Vidu family where "it might just not go through" is a live possibility depending on the upstream's current state. If it 502s on you, check the pack's release notes to see whether it's been cleared before you spend time debugging your own setup. When it does work, budget accordingly: an 8–12 second 1080p drama clip with assets is one of the pricier things this pack can do.

CategorySeedance

Inputs (27)

NameTypeDefaultDescription
modelCOMBOvidu-q3-drama-short-playVidu Q3 short-play model. | Vidu Q3 短剧成片模型。
promptSTRINGShort-play script content; forwarded as prompt/scriptContent. | 短剧脚本内容,会作为 prompt/scriptContent 提交。
script_nameSTRINGVidu short playForwarded as metadata.script_name for Vidu scriptName. | 透传为 metadata.script_name,对应 Vidu scriptName。
resolutionCOMBO1080pRequired by Vidu Q3 short-play. | Vidu Q3 短剧成片要求 1080p。
durationCOMBO8Short-play duration in seconds, 8-12. | 短剧成片时长,8-12 秒。
aspect_ratioCOMBO9:16Short-play aspect ratio. | 短剧成片画幅。
styleSTRINGrealisticVideo style, up to 30 characters. | 视频风格,最多 30 字符。
asset_typeCOMBOcharacterType used for all connected reference assets. | 所有连接参考资产使用的类型。
asset_name_prefixSTRINGAssetAsset names are built as '<prefix> 1', '<prefix> 2'. | 资产名称会生成为“前缀 1、前缀 2”。
asset_descriptionSTRINGReference assetDescription used for all connected assets. | 所有连接资产使用的描述。
asset_image1optIMAGEOptional short-play reference asset 1. At least asset_image1 is required. | 短剧参考资产图 1,至少需要 asset_image1。
asset_image2optIMAGEOptional short-play reference asset 2. At least asset_image1 is required. | 短剧参考资产图 2,至少需要 asset_image1。
asset_image3optIMAGEOptional short-play reference asset 3. At least asset_image1 is required. | 短剧参考资产图 3,至少需要 asset_image1。
asset_image4optIMAGEOptional short-play reference asset 4. At least asset_image1 is required. | 短剧参考资产图 4,至少需要 asset_image1。
asset_image5optIMAGEOptional short-play reference asset 5. At least asset_image1 is required. | 短剧参考资产图 5,至少需要 asset_image1。
asset_image6optIMAGEOptional short-play reference asset 6. At least asset_image1 is required. | 短剧参考资产图 6,至少需要 asset_image1。
asset_image7optIMAGEOptional short-play reference asset 7. At least asset_image1 is required. | 短剧参考资产图 7,至少需要 asset_image1。
asset_image8optIMAGEOptional short-play reference asset 8. At least asset_image1 is required. | 短剧参考资产图 8,至少需要 asset_image1。
asset_image9optIMAGEOptional short-play reference asset 9. At least asset_image1 is required. | 短剧参考资产图 9,至少需要 asset_image1。
asset_image10optIMAGEOptional short-play reference asset 10. At least asset_image1 is required. | 短剧参考资产图 10,至少需要 asset_image1。
asset_image11optIMAGEOptional short-play reference asset 11. At least asset_image1 is required. | 短剧参考资产图 11,至少需要 asset_image1。
asset_image12optIMAGEOptional short-play reference asset 12. At least asset_image1 is required. | 短剧参考资产图 12,至少需要 asset_image1。
asset_image13optIMAGEOptional short-play reference asset 13. At least asset_image1 is required. | 短剧参考资产图 13,至少需要 asset_image1。
asset_image14optIMAGEOptional short-play reference asset 14. At least asset_image1 is required. | 短剧参考资产图 14,至少需要 asset_image1。
api_configoptSEEDANCE_CONFIGConnect Seedance API Config; otherwise SEEDANCE_API_KEY is used.
skip_erroroptBOOLEANfalseOn failure return a placeholder error video instead of stopping the workflow. | 失败时输出占位错误视频。
seedoptINT00–18446744073709550000ComfyUI cache seed. Fixed reuses the cached result while all other inputs stay unchanged; randomize/increment/decrement starts a new execution. This value is not sent to models without documented seed support. | ComfyUI 缓存种子;Fixed 在其他输入不变时复用缓存,随机、递增或递减会触发新任务。未声明支持 seed 的模型不会收到此参数。

Outputs (4)

NameTypeDescription
videoVIDEO
video_urlSTRING
task_idSTRING
responseSTRING