wan / v3.0 / image-to-video
Prompt expansion is on, use it wisely
- source_image
- loras
- start_image
- end_image
- api_config
- video
- draft_cache_audio
- draft_cache_video
- workflow_id
- raw_json
Wan is the family that put open video on the map - Wan 2.1/2.2 are the base nearly every 2026 open video model is built on - and then Alibaba took the numbered series behind an API. That's the situation this node lives in: wan v3.0 is the closed, cloud-served generation, and Civitai resells it through this pack. The node itself is a quiet fan of the prompt: enable_prompt_expansion defaults to on, which per the tooltip means Alibaba's prompt rewriting runs before generation. Turn it off and you save 20–60 seconds of latency but lose quality - unless you follow Alibaba's prompting guide and write the expanded prompt yourself.
Part of civitai-comfy-nodes, Civitai's official ~160-node pack generated from its Orchestration API spec. Cloud job: submit a videoGen tagged wan / v3.0 / image-to-video, long-poll, get a native VIDEO tensor. Billed in Buzz, nothing local.
Inputs that matter
- prompt (required) and cfg_scale (required, default 4, range 0–100) - unusual to have cfg as a required field; it's the prompt-following dial, and Wan's family is known for respecting it.
- source_image (IMAGE socket) - the start frame.
- start_image / end_image - the one-two for loops and transitions;
end_image"constrains the last frame." - frame_rate (24), duration (1–30s, default 5), seed, steps (10–50, default 20).
- resolution - 480p, 720p, or 1080p (default).
- negative_prompt - supported here, unlike some of the pack's simpler engines.
- loras - CIVITAI_LORAS socket for a LoRA stack.
- enable_prompt_expansion (on) - described above; the latency-vs-quality lever.
- use_prime - run on
wan3.0-video-prime: same output quality, lower latency, higher price (that's the author's own billing note).
Outputs: video (VIDEO), draft_cache_audio (AUDIO), draft_cache_video (VIDEO), workflow_id and raw_json (STRING).
Install and auth
Standard for the pack - official, Comfy Registry:
# ComfyUI Manager: search "Civitai Comfy Nodes"
cd ComfyUI/custom_nodes
git clone https://github.com/civitai/civitai-comfy-nodes.git
pip install -r civitai-comfy-nodes/requirements.txt
Restart, authenticate via a Civitai Auth node, CIVITAI_API_TOKEN, or sidebar OAuth.
Common issues
Turning off prompt expansion without compensating is the classic footgun. The 20–60s latency saving sounds great until your output quality drops; if you disable it, write the verbose, detailed prompt yourself. use_prime is a price trade, not a quality trade - the tooltip is explicit: same quality, lower latency, higher price. Fine for deadline work, dumb as a default. 1080p default means every job bills at the top tier - drop to 720p for drafts. cfg_scale is required and matters - Wan's adherence responds strongly to it; if the video ignores your prompt, raise it before rewriting the text. Everything leaves your machine, and the pack is early preview - behavior can change without notice.
Inputs (15)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | — | |
| cfg_scale | FLOAT | 4.000–100 | — |
| source_imageopt | IMAGE | Either A URL, A DataURL or a Base64 string | |
| frame_rateopt | INT | 240–2147483647 | — |
| durationopt | INT | 51–30 | — |
| seedopt | INT | 00–4294967295 | — |
| stepsopt | INT | 2010–50 | — |
| lorasopt | CIVITAI_LORAS | — | |
| resolutionopt | COMBO | 1080p | 3 options: 480p, 720p, 1080p |
| negative_promptopt | STRING | — | |
| enable_prompt_expansionopt | BOOLEAN | true | Prompt rewriting. Disabling saves 20-60s of latency but may reduce generation quality — follow Alibaba's prompting guide when turning it off. |
| use_primeopt | BOOLEAN | false | Run on wan3.0-video-prime: same output quality, lower latency, higher price. |
| start_imageopt | IMAGE | Either A URL, A DataURL or a Base64 string | |
| end_imageopt | IMAGE | Constrains the last frame, for loops and transitions. | |
| api_configopt | CIVITAI_CONFIG | Optional Civitai Auth connection; defaults to CIVITAI_API_TOKEN or stored OAuth login. |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| video | VIDEO | — |
| draft_cache_audio | AUDIO | — |
| draft_cache_video | VIDEO | — |
| workflow_id | STRING | — |
| raw_json | STRING | — |