References and Source Media

References and source media

Prompt-driven references

Give media stable aliases, then mention only what a scene needs:

@hero         picture identity or appearance
@performance  motion video
@voice        audio reference

Tagged Ref2VA activates the aliases present in the current scene prompt and compiles them to compact native H3 labels. A scene that does not mention the tag does not consume that reference.

Use:

• Tagged Picture Ref for identity, appearance, or a visual object;
• Tagged Motion Ref for action and performance without requesting the source identity, wardrobe, setting, or composition;
• Tagged Audio Ref for voice, cadence, ambience, or other sound guidance;
• Tagged Video Ref when the whole video reference—not just motion—is the intended control.

Timed semantic picture anchors

#hero[2.50s] presents a tagged picture to Qwen again at an approximate scene-local time. It is semantic reinforcement, not a frame lock, pose lock, mask, ControlNet, or continuation boundary.

Start with two or three sparse anchors. Too many repeated pictures can resist the source video's changing pose.

Source Timeline

Register long source picture and sound once:

Load Video / Load Audio → Source Timeline → Preflight → Loop Start
                                              ↓
                                         Current Shot
                                              ↓
                                      active scene window

Path-backed media stays lazy. Only the active overlap-aware scene window is decoded, while the descriptor and fingerprints remain available for resume, Run Manager recovery, and assembly.

Use Source Timeline for:

• an exact source soundtrack;
• a long motion-reference video;
• continuing an existing clip;
• source-aligned masked editing;
• recovery without repeating full decoded AUDIO wires.

Do not return a Current Shot audio-slice fingerprint to Plan; that creates a graph cycle. Structured scene dependencies already record the exact source window used for generation.

See the complete reference guide for compliance modes, native numbering, storyboard anchors, previews, and the legacy numeric schedule route.