# Video model prompting research (for ComfyUI LLM prompt-enhancer platform profiles) Research date: 2026-09-20. Confidence labels: **high** = official source read directly (repo file cloned / vendor doc fetched); **medium** = official but indirect (vendor doc summarised by fetch tool, or official-but-adjacent); **low** = third-party only. Method notes: GitHub repos were cloned / raw files downloaded and read verbatim. Vendor web docs were read through a fetch-and-summarise tool, so wording of quotes from web docs may be lightly paraphrased. huggingface.co was not reachable from this environment (proxy 403), so HF model cards were NOT read directly. Official rewriter / enhancer system-prompt files (raw URLs) are collected in the last section. --- ## 1. Wan 2.2 (Alibaba Tongyi / Wan team) and later Wan releases ### 1.1 Release status matrix | Version | Weights | Audio generation | Notes | |---|---|---|---| | Wan 2.1 (Feb 2025) | Open, Apache-2.0 | No | T2V 1.3B/14B, I2V 14B, VACE, FLF2V | | Wan 2.2 (Jul 2025) | Open, Apache-2.0 | No (silent). S2V-14B is audio-*driven* (audio in, not out); Animate-14B is video-driven | T2V-A14B, I2V-A14B (MoE high/low-noise experts, boundary 0.875), TI2V-5B (24 fps, 121 frames, 720p) | | Wan 2.5 (preview, Sep 2025) | API only | Yes ("automatic dubbing" or custom `audio_url`) | 5 or 10 s; prompt <= 1500 chars | | Wan 2.6 (Dec 2025) | API only | Yes | 2-15 s; multi-shot; reference-to-video (`character1` ...); prompt <= 1500 chars | | Wan 2.7 (API ids `wan2.7-i2v-2026-04-25`, `wan2.7-t2v-2026-06-12`) | API only | Yes (generates BGM/SFX when no `audio_url`; `driving_audio` supported) | 2-15 s; 720P/1080P; prompt <= 5000 chars | | Wan 3.0 (public beta Aug 2026 per third parties) | API only as of research date. `github.com/AlibabaCloud-Official/Wan3.0` exists but is a marketing README with NO weights/code | Yes | native 30 s, up to 20 reference assets (README claims) | | Wan-Dancer-14B (Jul 2026) | Open (official `Wan-Video/Wan-Dancer` repo) | Music-driven dance video (audio in) | niche | Verified by probing: `Wan-Video/Wan2.5`, `Wan2.6`, `Wan2.7`, `Wan3`, `Wan3.0` repos do not exist (404) on GitHub; `Wan-Video/Wan2.1`, `Wan2.2`, `Wan-Dancer` exist. Third-party SEO sites contradict each other on Wan 3.0 open weights (wan27.org claims open 1.3B/14B weights; atlascloud and wavespeed, both of which checked the official orgs on Aug 20-25 2026, say no weights). Treat "Wan 3.0 open weights" as **not found / unconfirmed**. ### 1.2 Core facts (Wan 2.2 open weights) - Developer: Alibaba (Wan team / Tongyi Lab). - Text encoder: **umT5-XXL** (`google/umt5-xxl` tokenizer), `text_len = 512` tokens (hard truncation). Multilingual; Chinese and English both first-class. - Caption style: dense prose. Official rewriter output for T2V = leading comma-separated cinematic tags (lighting, shot size, composition, tone) followed by descriptive sentences. Style phrase goes FIRST if a style is specified. - Recommended length: official T2V rewriter targets **60-200 words** (ZH: 60-200 字); official I2V rewriter targets **<= 100 words**. Hosted API limit for wan2.2: 800 characters; negative prompt 500 chars. - Negative prompt: **supported** (CFG; guide scale (3.0, 4.0) low/high noise for A14B, 5.0 for 5B). Note: distilled/LightX2V-style 4-step LoRA workflows run CFG=1 where the negative prompt has no effect (community knowledge, not from an official source). - Standard Chinese negative prompt (verbatim from `wan/configs/shared_config.py`): `色调艳丽,过曝,静态,细节模糊不清,字幕,风格,作品,画作,画面,静止,整体发灰,最差质量,低质量,JPEG压缩残留,丑陋的,残缺的,多余的手指,画得不好的手部,画得不好的脸部,畸形的,毁容的,形态畸形的肢体,手指融合,静止不动的画面,杂乱的背景,三条腿,背景人很多,倒着走` - Audio: none in 2.2. Never write dialogue/sound cues for Wan 2.2 (wasted tokens). The words "speaks/talks" are fine as *visual* motion ("a man talks, his gestures lively"). - Defaults: 16 fps, 81 frames (~5 s) for A14B; 24 fps, 121 frames for TI2V-5B. Actions must fit ~5 s. ### 1.3 Official prompt formula (Alibaba Cloud Model Studio guide) - Basic: **Entity + Scene + Motion**. - Advanced: **Entity description + Scene description + Motion description + Aesthetic control + Stylization**. Aesthetic control = light source, lighting environment, shot size, camera angle, lens, camera movement. Motion description should carry amplitude/speed ("swaying violently", "moving slowly"). - I2V: **Motion + Camera movement** only. The image already defines entity, scene and style. Use speed/intensity adverbs; "fixed camera" to lock. - Sound formula (Wan 2.5/2.6/2.7/3.0 only): Entity + Scene + Motion + **Sound description (voice / sound effect / BGM)**. - Voice: `Character's lines + Emotion + Tone + Speed + Timbre + Accent`. Example: *A man doing stand-up comedy says, 'Study hard and make progress every day,' in a relaxed tone, at moderate speed, with a clear voice, in American English.* - SFX: `Source material + Action + Ambient sound`. BGM: `Background music/score + Style`. - Multi-speaker rules: unique consistent labels (no pronouns), bind each line to a visible action ("The agent slams his hand on the table. [Black-suited Agent, angrily]: 'Where is the truth?'"), distinct voice label per character, explicit temporal linking words ("Immediately, ...") so lines do not merge. - Suppression phrases (2.7/3.0 reference-to-video): "No dialogue.", "No background music." - Multi-shot (2.6/2.7/3.0): `Overall description + Shot number + Timestamp + Shot content`, e.g. `Shot 1 [0-3 s] ...`. For a single shot on 2.7 write "Generate single shot." - Reference-to-video: 2.7/3.0 use "Image 1"/"Video 1" identifiers; 2.6 uses `character1`, `character2`. - Guide's "do not prompt" list: real people by name, rapid scene changes within a clip, exact legible text, very long action sequences, exact lip-sync to specific words. ### 1.4 Vocabulary the official rewriter draws from (verbatim English lists in `T2V_A14B_EN_SYS_PROMPT`) - Time: Day time, Night time, Dawn time, Sunrise time (default Day time) - Light source: Daylight, Artificial lighting, Moonlight, Practical lighting, Firelight, Fluorescent lighting, Overcast lighting, Sunny lighting - Intensity: Soft lighting, Hard lighting. Angle: Top lighting, Side lighting, Underlighting, Edge lighting - Tone: Warm colors, Cool colors, Mixed colors - Shot size: Medium shot, Medium close-up shot, Wide shot, Medium wide shot, Close-up shot, Extreme close-up shot, Extreme wide shot (default Medium or Wide) - Angle: Over-the-shoulder shot, Low angle shot, High angle shot, Dutch angle shot, Aerial shot, Overhead shot (omit if user gave camera movement) - Composition: Center, Balanced, Right-heavy, Left-heavy, Symmetrical, Short-side composition - Camera movement phrasing seen in official examples / Model Studio guide: "camera pushes in", "camera pulls back/out", "camera moves left/right", "the camera pans up", "camera tilts downward", "tracking shot", "orbit (keep arc under 45 degrees)", "fixed camera", compound moves (drone shot, fly-through, tilt up). The EN rewriter prompt picks **at most 4** aesthetic tags. ### 1.5 Rewriter behaviour worth copying (from the system prompts) - Do not change subject/action; do not add subjects that were not in the prompt (no people added to landscapes). - Do NOT output literary mood sentences ("the scene is full of tension"). - Describe the motion process in detail; if no motion is given, add some (body sway, clouds drifting, wind in leaves). - Style: if absent do not add one; if present put it first; for 2D/illustration styles skip the cinematic-lighting tags. - Sky mentioned -> rewrite as "azure blue sky" to avoid overexposure. - I2V: keep dynamic parts, keep and emphasise camera-move text, remove descriptions of static things already visible in the image, expand bare verbs using the image ("dancing" -> "a girl is dancing"), <= 100 words. There is a separate "EMPTY" prompt for I2V with no user text (imagine plausible motion from the image). - CAUTION: rules 8-10 of the T2V prompts are vendor content-moderation rules that silently *replace* the user's prompt (including for same-sex kissing and bikini content). They are policy, not prompting technique; do not copy them into a local enhancer. ### 1.6 Do / Don't Do: 80-120 words EN, tags first then prose; explicit motion verbs with speed; one camera move; Chinese or English. Don't: exceed 512 tokens; write audio cues; describe the image in I2V; ask for legible text; pile multiple scene cuts into 5 s. ### Sources - https://raw.githubusercontent.com/Wan-Video/Wan2.2/main/wan/utils/system_prompt.py — all six official rewriter prompts, length targets, vocab lists (**high**, read verbatim) - https://raw.githubusercontent.com/Wan-Video/Wan2.2/main/wan/configs/shared_config.py — umT5-XXL, text_len 512, negative prompt, 16 fps/81 frames (**high**) - https://github.com/Wan-Video/Wan2.2 (README) — prompt extension methods (Dashscope / local Qwen), S2V, Animate, guide scales (**high**) - https://www.alibabacloud.com/help/en/model-studio/text-to-video-prompt — official formulas, sound formula, multi-shot, version compatibility table, camera/style vocab (**medium**: official page, read via summariser) - https://www.alibabacloud.com/help/en/model-studio/text-to-video-api-reference and https://www.alibabacloud.com/help/en/model-studio/legacy-wan-text-to-video-api-reference and https://www.alibabacloud.com/help/en/model-studio/image-to-video-general-api-reference — char limits, negative_prompt 500 chars, audio behaviour, durations, `prompt_extend` default true (**medium**) - https://raw.githubusercontent.com/AlibabaCloud-Official/Wan3.0/main/README.md — Wan 3.0 feature claims, no weights present (**high** for "no weights in that repo") - https://www.atlascloud.ai/blog/tips/is-wan-3.0-open-source , https://wavespeed.ai/blog/video-model-access/is-wan-3-0-open-source/ — Wan 2.5-3.0 API-only as of late Aug 2026 (**low**); https://wan27.org/blog/wan-3-open-source claims the opposite (**low**, judged unreliable: also wrongly says Wan 2.5 has no audio) --- ## 2. LTX-2 / LTX-2.3 / LTX-2.5 (Lightricks) — joint audio + video, open weights ### 2.1 Versions - **LTX-2** (Jan 2026, 19B): Gemma 3 12B text encoder. [parameter count from memory, not re-verified: medium] - **LTX-2.3** (22B, dev + distilled 1.1; "legacy" in the repo now): Gemma 3 12B (`google/gemma-3-12b-it-qat-q4_0-unquantized`), redesigned text connector, better audio. - **LTX-2.5** (repo changelog 1.2.0, **2026-08-11**): 22B dev + distilled transformers, **Gemma 4 12B fine-tuned for LTX** (`gemma4-12b-with-proj-ltx-2.5`, stock Gemma 4 is not a substitute), diffusion video-VAE decoder, separate audio VAE, optional **duration head** (clip length predicted from the caption), DFR pipeline up to 4K, Dub-It, A2Vid, Retake, HDR. License: LTX community license (free under $10M ARR, per LTX blog). ComfyUI: `Lightricks/ComfyUI-LTXVideo` (has 2.5 workflows). - Tokenizer pads/truncates prompts to **1024 tokens** (hard limit, from `base_encoder.py`). ### 2.2 Caption style and length - **Single flowing paragraph, present tense, chronological, literal.** No headings, no "Audio:" / "Visual:" labels, no bullet lists. Start directly with the action (never "The scene opens with..."). - README: "Keep within 200 words." Blog guides: 4-8 descriptive sentences; LTX-2.3+: "longer, more descriptive prompts consistently outperform short ones"; make sure prompt content fills the clip duration (8-10 s) or the model rushes. - LTX-2.5 official enhancer target: **roughly 150-220 words**. LTX-2/2.3 enhancer: `max_new_tokens` 512. - README structure: main action in one sentence -> movements/gestures -> appearances -> background/environment -> camera angles and movements -> lighting and colours -> changes/sudden events. - Blog six elements: establish the shot; set the scene; describe the action; define characters (age, hair, clothing; emotion via physical cues); camera movement; **describe the audio**. - Optional leading style tag (Gemma-3 enhancer): `Style: