Nodes/ComfyUI-dapaoAPI/🦁Wan3.0-官方全能视频@炮老师的小课堂
ComfyUI Node

🦁Wan3.0-官方全能视频@炮老师的小课堂

Four Modes, Someone Else's GPU

By paolaoshi·Created 11 months ago·Updated 2 days ago· 229
🦁Wan3.0-官方全能视频@炮老师的小课堂
  • 🎬 首帧图
  • 🏁 尾帧图
  • 🖼️ 参考图1
  • 🖼️ 参考图2
  • 🖼️ 参考图3
  • 🖼️ 参考图4
  • 🖼️ 参考图5
  • 🖼️ 参考图6
  • 🖼️ 参考图7
  • 🖼️ 参考图8
  • 🖼️ 参考图9
  • 🖼️ 参考图10
  • 🎞️ 参考视频1
  • 🎞️ 参考视频2
  • 🎞️ 参考视频3
  • 🎞️ 参考视频4
  • 🎞️ 参考视频5
  • 🎵 参考音频1
  • 🎵 参考音频2
  • 🎵 参考音频3
  • 🎵 参考音频4
  • 🎵 参考音频5
  • 🎬 视频
  • 🆔 任务ID
  • 📋 响应信息
  • 🔗 视频URL
🔑 API密钥
🤖 模型wan3.0-video-official
🎛️ 生成模式文生视频
📝 提示词电影感镜头,主体动作自然,画面稳定,光影与声音细节丰富
🧩 分辨率720P
📐 视频比例自适应
⏱️ 时长(秒)5
🔊 生成音频true
🎲 随机种0
🔁 最大轮询秒数3600
⏱️ 轮询间隔5
⌛ 请求超时180
🚫 出错时跳过false

Wan 3.0 is never coming to your GPU

Wan 2.2 is the last open Wan. Alibaba shipped 2.5, 2.6 and 2.7 as cloud previews with no weights, people asked for months whether the open line was dead, and it stayed dead. Wan 3.0 continues that pattern. So every "Wan 3.0 in ComfyUI" node you'll find is a relay, and this one is no exception: it POSTs to api.dapaoai.com, and the word "官方" (official) in its name means official Alibaba model IDs (wan3.0-video-official, wan3.0-video-prime-official) behind a Chinese reseller gateway - not ComfyUI's Partner Node storefront. You still need that reseller's key and a funded wallet.

Why reach for it when Wan 2.2 runs free on your card? Audio, mainly. 🔊 生成音频 is on by default and native audio is the thing local Wan 2.2 simply doesn't do. Then length - up to 30 seconds in one generation, where local Wan clips out around 81 frames - and multi-modal reference mode, where you hand it reference images, clips and audio and describe them by position. On a 5090, 720p Wan 2.2 is roughly 25 minutes a clip without speed LoRAs.

Which is the honest tradeoff: local Wan is free, uncensored and Apache 2.0; this is metered per second of output, and your prompts and media leave the machine. For five seconds of b-roll you could have generated locally, stay local.

What the node actually does for you

It's the plumbing nobody wants to write. Four modes: 文生视频 sends the prompt alone; 图生视频 requires 🎬 首帧图 and sends it as a first_frame; 首尾帧生视频 requires both 首帧图 and 🏁 尾帧图 and sends first_frame + last_frame; 多模态参考 assembles reference_image, reference_video and reference_audio entries from the reference slots, and you address them in the prompt as 图1, 视频1, 音频1. Reference media is only read in that mode - wire a 🎞️ 参考视频1 while in any other mode and it stops with "参考视频只在多模态参考模式使用".

Everything gets transcoded locally before upload: images scaled to a 2048 long edge (JPEG quality walked from 88 down to 72 until each is under ~8MB), video re-encoded to MP4/H.264/AAC at ≤1080p and ≤30fps, audio to MP3. Caps: 10 images, 5 videos, 5 audios; images ≤20MB total, reference video ≤15 seconds, audio ≤15MB and ≤15 seconds. With a reference video in play, the generated clip is capped at 15 seconds too.

Submission runs through a local sqlite queue with Prefer: respond-async, and identical payloads reuse the already-paid task instead of being resubmitted - a real kindness when a 1080p job is sitting in a queue. The 🎬 视频 output is a small adapter whose save_to() pulls the file from the gateway's /v1/videos/<task_id>/content endpoint (following a signed redirect without your key), so it drops into Preview Video or Save Video like anything else.

Inputs worth caring about

  • 🔑 API密钥 - leave it blank and set DAPAO_API_KEY instead. That's the author's own tooltip, and the code honours it. Per the tooltip the key only ever goes to api.dapaoai.com; pasting it into the widget risks it being saved inside an ordinary workflow file.
  • 🎛️ 生成模式 and 🤖 模型 - validated together; both official model IDs accept reference video.
  • 🧩 分辨率 (480P/720P/1080P) + 📐 视频比例 + ⏱️ 时长(秒) (2–30). 自适应 is sent as ratio: "adaptive".
  • 🔊 生成音频 - default on.
  • 🎲 随机种 - be real about this one. The tooltip says plainly that the 妙笔 Wan endpoint doesn't take a seed; the widget exists to control ComfyUI's cache and re-execution. Don't expect the same clip twice.
  • 🚫 出错时跳过 - returns an empty video plus empty strings instead of raising. Wonderful for long batch runs, awful for debugging: the graph goes green with nothing in it. Read 📋 响应信息.
  • prompt_extend is hardcoded on and watermark hardcoded off here, so there's no widget for either, unlike the image nodes in this pack.

Outputs: 🎬 视频, 🆔 任务ID, 📋 响应信息 (mode, resolution, asset counts, task ID, elapsed time, the billing note) and 🔗 视频URL. Keep the last two around; if the download misbehaves you can still fetch the clip.

Install

ComfyUI Manager: search dapaoAPI, install, restart. Or:

cd ComfyUI/custom_nodes && git clone https://github.com/paolaoshi/ComfyUI-dapaoAPI
pip install -r ComfyUI-dapaoAPI/requirements.txt   # requests, Pillow, torch, numpy, zhipuai, aiohttp, nest-asyncio, scipy

No models to download - the weights are on someone else's machine. But if you want reference video or audio, install ffmpeg and ffprobe on your PATH; the transcoding shells out to them and the pack doesn't bundle them. Miss them and you get "未找到 ffprobe,无法自动优化素材" the moment the node touches a clip. You can point DAPAO_FFMPEG_PATH / DAPAO_FFPROBE_PATH at your binaries instead.

Where it breaks

Errors are mapped from HTTP status to readable causes, which is more helpful than most relays: 401 is a bad key, 402 is an empty wallet, 403 is no model permission, 413 is media or request too large, 429 is rate-limiting or queueing - and both 413 and 429 mention oversized images, so let the node's own 2K preprocessing do its job rather than feeding it 4K plates. Reference videos outside 1–15 seconds are rejected outright.

Timeouts trip people up. ⌛ 请求超时 (180s) is the HTTP request; 🔁 最大轮询秒数 (3600s, up to 7200) is how long the node waits for the upstream job. A 1080p generation that "failed" is usually polling.

And the shared caveat for this whole category: it's a metered call on a reseller gateway, and the English-language community has essentially nothing on this pack - no threads, no reception either way - so your documentation is the README and the node's own error strings. Read what it sends before you trust it with a key.

Category🤖dapaoAPI/🍬大炮AI主力维护🍬

Inputs (35)

NameTypeDefaultDescription
🔑 API密钥STRING建议留空并设置环境变量 DAPAO_API_KEY;直接填写的值可能随普通 ComfyUI 工作流保存。密钥只发送到 https://api.dapaoai.com。
🤖 模型COMBOwan3.0-video-official2 options: wan3.0-video-official, wan3.0-video-prime-official
🎛️ 生成模式COMBO文生视频4 options: 文生视频, 图生视频, 首尾帧生视频, 多模态参考
📝 提示词STRING电影感镜头,主体动作自然,画面稳定,光影与声音细节丰富
🧩 分辨率COMBO720P3 options: 480P, 720P, 1080P
📐 视频比例COMBO自适应7 options: 自适应, 21:9, 16:9, 4:3, 1:1, 3:4, +1
⏱️ 时长(秒)COMBO52–30秒;使用参考视频时最多15秒。
🔊 生成音频BOOLEANtrue
🎲 随机种INT00–18446744073709550000控制 ComfyUI 缓存和重新执行;生成后控制可选择固定、递增、递减或随机化。当前妙笔 Wan 3.0 接口不接收 seed。
🎬 首帧图optIMAGE图生或首尾帧模式必需;批次只取第1张。最长边自动压至2K。
🏁 尾帧图optIMAGE首尾帧模式必需;批次只取第1张。
🔁 最大轮询秒数optINT360060–7200
⏱️ 轮询间隔optINT52–30
⌛ 请求超时optINT18030–600
🚫 出错时跳过optBOOLEANfalse
🖼️ 参考图1optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图1”。
🖼️ 参考图2optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图2”。
🖼️ 参考图3optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图3”。
🖼️ 参考图4optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图4”。
🖼️ 参考图5optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图5”。
🖼️ 参考图6optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图6”。
🖼️ 参考图7optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图7”。
🖼️ 参考图8optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图8”。
🖼️ 参考图9optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图9”。
🖼️ 参考图10optIMAGE多模态参考图,最多10张,合计不超过20MB;提示词可按上传顺序写“图10”。
🎞️ 参考视频1optVIDEO官方 Wan 多段参考视频合计不超过15秒;自动转MP4/H.264/AAC、≤1080p/30fps;提示词写“视频1”。
🎞️ 参考视频2optVIDEO官方 Wan 多段参考视频合计不超过15秒;自动转MP4/H.264/AAC、≤1080p/30fps;提示词写“视频2”。
🎞️ 参考视频3optVIDEO官方 Wan 多段参考视频合计不超过15秒;自动转MP4/H.264/AAC、≤1080p/30fps;提示词写“视频3”。
🎞️ 参考视频4optVIDEO官方 Wan 多段参考视频合计不超过15秒;自动转MP4/H.264/AAC、≤1080p/30fps;提示词写“视频4”。
🎞️ 参考视频5optVIDEO官方 Wan 多段参考视频合计不超过15秒;自动转MP4/H.264/AAC、≤1080p/30fps;提示词写“视频5”。
🎵 参考音频1optAUDIO参考音频最多5个、合计不超过15MB;自动转MP3;提示词写“音频1”。
🎵 参考音频2optAUDIO参考音频最多5个、合计不超过15MB;自动转MP3;提示词写“音频2”。
🎵 参考音频3optAUDIO参考音频最多5个、合计不超过15MB;自动转MP3;提示词写“音频3”。
🎵 参考音频4optAUDIO参考音频最多5个、合计不超过15MB;自动转MP3;提示词写“音频4”。
🎵 参考音频5optAUDIO参考音频最多5个、合计不超过15MB;自动转MP3;提示词写“音频5”。

Outputs (4)

NameTypeDescription
🎬 视频VIDEO
🆔 任务IDSTRING
📋 响应信息STRING
🔗 视频URLSTRING