DigitalByte commited on
Commit
32565b5
·
verified ·
1 Parent(s): a5b1754

Add first/last-frame guidance, unwrap templates, refresh prompt guide

Browse files

Uploaded via huggingface_hub API. Workflow and training_config.yaml already match the remote.

Files changed (2) hide show
  1. README.md +13 -54
  2. prompt_guide.md +78 -107
README.md CHANGED
@@ -57,6 +57,12 @@ Turn a source image into an animated exploded view. XPLDV separates an object's
57
 
58
  XPLDV works best with `ltx-2.5-22b-distilled-transformer-bf16.safetensors`. It can also be used with `ltx-2.5-22b-dev-transformer-bf16.safetensors`, which it was trained on. The included workflow uses the distilled model. Base models: [Lightricks/LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5).
59
 
 
 
 
 
 
 
60
  ## Featured videos
61
 
62
  Six 10-second examples using XPLDV at strength **0.5**. Each video includes its exact prompt.
@@ -107,31 +113,20 @@ Change one setting at a time while keeping the image, prompt, and seed fixed.
107
 
108
  Start with **"separates into an ordered exploded view."** This phrase appears in all 204 separation training captions. Name the parts that move, the components revealed underneath, and the final arrangement. Write one continuous paragraph.
109
 
 
 
110
  “Separates into individual components” is another phrasing we tested. With either opening, describe the movement and the final arrangement.
111
 
112
  ### BASIC template — a short, readable reveal
113
 
114
  ```text
115
- [SUBJECT] separates into an ordered exploded view. [NAMED OUTER PARTS] move
116
- outward along controlled paths, revealing [NAMED INTERNAL COMPONENTS]
117
- underneath. The parts settle into an organized [LAYERED / RADIAL]
118
- arrangement around [EXPOSED CORE] while retaining their original shapes.
119
- [CAMERA BEHAVIOR]. [LIGHTING CONSISTENT WITH THE IMAGE] remains consistent
120
- throughout the continuous shot.
121
  ```
122
 
123
  #### Example: Desktop PC
124
 
125
  ```text
126
- The desktop computer tower separates into an ordered exploded view. The
127
- glass side panel, front panel, top cover and lower power-supply cover move
128
- outward along controlled paths, revealing the motherboard, graphics card,
129
- liquid-cooling assembly and power supply. The components separate into an
130
- organized layered arrangement around the case while retaining their original
131
- shapes. The case base stays on the desk. The camera slowly orbits to the
132
- right around the computer from the starting three-quarter view. The
133
- blue-white computer lighting and surrounding room remain consistent
134
- throughout the continuous shot.
135
  ```
136
 
137
  [Watch the example](examples/xpldv_computer.mp4)
@@ -141,54 +136,18 @@ throughout the continuous shot.
141
  A COMPLEX prompt guides a more detailed, cinematic reveal through successive layers, describing deeper internal components, their appearance, and their positions, including details hidden or difficult to see in the starting image. These descriptions give LTX 2.5 the information needed to construct the intended reveal beyond what the image alone shows.
142
 
143
  ```text
144
- [SUBJECT] separates into an ordered exploded view while [CONTINUING ACTION
145
- OR ANCHORED SUPPORT]. [OUTER PART A] detaches and translates [DIRECTION],
146
- keeping [ORIENTATION]. [OUTER PART B] moves [DISTINCT PATH], and [OTHER
147
- OUTER PARTS] move [PATHS]. These exterior parts move first and travel
148
- furthest, leaving clear gaps. They reveal [SPECIFIC COMPONENT AND
149
- RECOGNIZABLE FEATURES] at [POSITION RELATIVE TO THE OBJECT], with [OTHER
150
- COMPONENTS AND THEIR LOCATIONS]. [CORE COMPONENTS] remain mounted together.
151
- Each detached section retains its shape as the arrangement settles and holds
152
- steady. [CAMERA BEHAVIOR]. [CONSISTENT LIGHTING] continues through one
153
- continuous shot.
154
  ```
155
 
156
  #### Example: Watch
157
 
158
  ```text
159
- A luxury automatic mechanical wristwatch separates into an ordered exploded
160
- view while resting stationary on its dark velvet display cushion. The front
161
- sapphire crystal and surrounding polished bezel rim detach as a single unit
162
- and translate forward and slightly upward, keeping its circular orientation
163
- facing the camera. The hour, minute, and slender seconds hands lift cleanly
164
- above the dial plane, each translating upward along its own short vertical
165
- path with slight lateral spacing between them. The main dial plate carrying
166
- its applied hour markers, subdial components, and open-heart cutout details
167
- moves forward a shorter distance than the crystal, creating a clear gap
168
- between it and the hands above. These exterior parts move first and travel
169
- furthest, leaving generous gaps between each successive layer. They reveal
170
- the mechanical movement at the center of the stack—its polished bridges,
171
- interlocking gears, escapement fork, oscillating balance wheel, ruby jewels,
172
- and complication modules all visible in their assembled configuration—with
173
- the rear exhibition caseback and its oscillating automatic rotor translating
174
- backward and slightly downward as the final layer. The movement's bridges,
175
- gears, and escapement remain mounted together as a single mechanical unit.
176
- Each detached section retains its original shape as the five layers settle
177
- into an organized axial arrangement and hold steady. A slow, steady camera
178
- pull-back provides room for the full expanded stack. The soft upper-left key
179
- light, cool right-side fill, and subtle rim highlight consistent with the
180
- source image continue through one continuous shot.
181
  ```
182
 
183
  [Watch the example](examples/xpldv_watch.mp4)
184
 
185
- Keep related parts within a named internal mechanism intact when useful, such as the gears inside a watch movement. This does not keep the exterior attached. Describe which internal layers also move; omit the sentence about components remaining mounted together when it does not fit the reveal.
186
-
187
- Replace the brackets with your subject and its parts; omit clauses that do not apply to the intended shot. Name the final arrangement: a vertical stack, a horizontal row, or a radial arrangement around the center. Use “layered” for an actual stack. Describe timing consistently: parts move at the same time or in a clear sequence. For a moving subject, keep the detached parts traveling with it. Give the camera enough room for the expanded arrangement.
188
-
189
- Audio is optional. Add sound effects, ambience, music, or dialogue in a final sentence and keep the audio pipeline connected. Audio wording can influence the visual action.
190
-
191
- See the [prompt guide](prompt_guide.md) for a short walkthrough and troubleshooting tips.
192
 
193
  ## Limitations and tips
194
 
 
57
 
58
  XPLDV works best with `ltx-2.5-22b-distilled-transformer-bf16.safetensors`. It can also be used with `ltx-2.5-22b-dev-transformer-bf16.safetensors`, which it was trained on. The included workflow uses the distilled model. Base models: [Lightricks/LTX-2.5](https://huggingface.co/Lightricks/LTX-2.5).
59
 
60
+ ## First and last frame guidance
61
+
62
+ First/last-frame generation also works well with XPLDV. Supply the assembled subject as the first image and a matching exploded arrangement as the last image. **In this setup, XPLDV provides motion guidance for the separation between the two images.** The endpoint images establish the starting appearance and intended final arrangement; the prompt describes which parts detach, their paths, and the ongoing subject and camera movement.
63
+
64
+ This approach worked well for the burger and running-shoe reveals in the demo reel. Use a workflow that accepts both image guides. The included example workflow uses one starting image; see the [first/last-frame setup and prompting notes](prompt_guide.md#first-and-last-frame-guidance) for the tested two-guide setup.
65
+
66
  ## Featured videos
67
 
68
  Six 10-second examples using XPLDV at strength **0.5**. Each video includes its exact prompt.
 
113
 
114
  Start with **"separates into an ordered exploded view."** This phrase appears in all 204 separation training captions. Name the parts that move, the components revealed underneath, and the final arrangement. Write one continuous paragraph.
115
 
116
+ Use the [slot reference](prompt_guide.md#filling-the-slots) to fill the placeholders in either template.
117
+
118
  “Separates into individual components” is another phrasing we tested. With either opening, describe the movement and the final arrangement.
119
 
120
  ### BASIC template — a short, readable reveal
121
 
122
  ```text
123
+ [SUBJECT] separates into an ordered exploded view. [NAMED OUTER PARTS] move outward along controlled paths, revealing [NAMED INTERNAL COMPONENTS] underneath. The parts settle into an organized [LAYERED / RADIAL] arrangement around [EXPOSED CORE] while retaining their original shapes. [CAMERA BEHAVIOR]. [LIGHTING CONSISTENT WITH THE IMAGE] remains consistent throughout the continuous shot.
 
 
 
 
 
124
  ```
125
 
126
  #### Example: Desktop PC
127
 
128
  ```text
129
+ The desktop computer tower separates into an ordered exploded view. The glass side panel, front panel, top cover and lower power-supply cover move outward along controlled paths, revealing the motherboard, graphics card, liquid-cooling assembly and power supply. The components separate into an organized layered arrangement around the case while retaining their original shapes. The case base stays on the desk. The camera slowly orbits to the right around the computer from the starting three-quarter view. The blue-white computer lighting and surrounding room remain consistent throughout the continuous shot.
 
 
 
 
 
 
 
 
130
  ```
131
 
132
  [Watch the example](examples/xpldv_computer.mp4)
 
136
  A COMPLEX prompt guides a more detailed, cinematic reveal through successive layers, describing deeper internal components, their appearance, and their positions, including details hidden or difficult to see in the starting image. These descriptions give LTX 2.5 the information needed to construct the intended reveal beyond what the image alone shows.
137
 
138
  ```text
139
+ [SUBJECT] separates into an ordered exploded view while [CONTINUING ACTION OR ANCHORED SUPPORT]. [OUTER PART A] detaches and translates [DIRECTION], keeping [ORIENTATION]. [OUTER PART B] moves [DISTINCT PATH], and [OTHER OUTER PARTS] move [PATHS]. These exterior parts move first and travel furthest, leaving clear gaps. They reveal [SPECIFIC COMPONENT AND RECOGNIZABLE FEATURES] at [POSITION RELATIVE TO THE OBJECT], with [OTHER COMPONENTS AND THEIR LOCATIONS]. [CORE COMPONENTS] remain mounted together. Each detached section retains its shape as the arrangement settles and holds steady. [CAMERA BEHAVIOR]. [CONSISTENT LIGHTING] continues through one continuous shot.
 
 
 
 
 
 
 
 
 
140
  ```
141
 
142
  #### Example: Watch
143
 
144
  ```text
145
+ A luxury automatic mechanical wristwatch separates into an ordered exploded view while resting stationary on its dark velvet display cushion. The front sapphire crystal and surrounding polished bezel rim detach as a single unit and translate forward and slightly upward, keeping its circular orientation facing the camera. The hour, minute, and slender seconds hands lift cleanly above the dial plane, each translating upward along its own short vertical path with slight lateral spacing between them. The main dial plate carrying its applied hour markers, subdial components, and open-heart cutout details moves forward a shorter distance than the crystal, creating a clear gap between it and the hands above. These exterior parts move first and travel furthest, leaving generous gaps between each successive layer. They reveal the mechanical movement at the center of the stack—its polished bridges, interlocking gears, escapement fork, oscillating balance wheel, ruby jewels, and complication modules all visible in their assembled configuration—with the rear exhibition caseback and its oscillating automatic rotor translating backward and slightly downward as the final layer. The movement's bridges, gears, and escapement remain mounted together as a single mechanical unit. Each detached section retains its original shape as the five layers settle into an organized axial arrangement and hold steady. A slow, steady camera pull-back provides room for the full expanded stack. The soft upper-left key light, cool right-side fill, and subtle rim highlight consistent with the source image continue through one continuous shot.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
146
  ```
147
 
148
  [Watch the example](examples/xpldv_watch.mp4)
149
 
150
+ See the prompt guide for [motion, preservation, and optional audio](prompt_guide.md#keep-the-shot-consistent), plus [troubleshooting](prompt_guide.md#when-the-result-needs-work).
 
 
 
 
 
 
151
 
152
  ## Limitations and tips
153
 
prompt_guide.md CHANGED
@@ -1,43 +1,73 @@
1
  # Prompting XPLDV
2
 
3
- Start with **“separates into an ordered exploded view.”** Name what moves, what becomes visible, and where the parts finish. Use direct words such as **moves up**, **moves outward**, and **remains suspended**.
4
 
5
- “Separates into individual components” is another phrasing we tested. With either opening, describe the movement and the final arrangement.
6
 
7
- Use the [BASIC and COMPLEX templates](README.md#prompting) to start. A BASIC prompt names the main parts and the intended reveal.
8
 
9
- A COMPLEX prompt guides a more detailed, cinematic reveal through successive layers, describing deeper internal components, their appearance, and their positions, including details hidden or difficult to see in the starting image. These descriptions give LTX 2.5 the information needed to construct the intended reveal beyond what the image alone shows.
10
 
11
- The [featured videos](README.md#featured-videos) contain complete prompts, and the [recommended settings](README.md#recommended-settings) are in the README.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
12
 
13
- ## Build the reveal
14
 
15
- 1. **Choose the subject.** Describe the main object in the image. If several objects are visible, identify yours by its position or appearance.
16
- 2. **Name what separates.** Each exterior part selected for separation must come completely free, move away, and remain suspended with a visible gap from the subject. Name parts individually when they should detach independently.
17
- 3. **Name what becomes visible.** Be specific about the important interior parts and where they belong: “the V6 engine block ahead of the cabin” or “the battery beneath the palm rest.” Add recognizable features only when they help describe the reveal.
18
- 4. **Describe the finish.** State that the detached parts remain suspended with visible gaps and keep their original shapes. Describe which internal layers also move and which remain in place.
19
 
20
- Match the final arrangement to the movement:
21
 
22
- | Movement | Example wording |
23
- | --- | --- |
24
- | Vertical stack | “The screen, frame, and circuit board move vertically apart and remain suspended in aligned layers with visible gaps.” |
25
- | Horizontal row | “The components move horizontally apart and remain suspended in an ordered row.” |
26
- | Radial | “The panels move outward from the frame in a radial arrangement and remain suspended with visible gaps.” |
27
 
28
- Use “layered” for a stack. Different parts can move in different directions: a hood moves upward while doors move sideways. Add orientation details when they matter, such as keeping a glass cover flat.
 
29
 
30
- Describe one consistent timing pattern. If parts start together, say they move apart simultaneously. If they separate in stages, describe that order. Do not combine “first, then” with a requirement that every part start together.
31
 
32
- Keep related parts within a named internal mechanism intact when useful, such as the gears inside a watch movement. This does not keep the exterior attached. Describe which internal layers also move; omit the sentence about components remaining mounted together when it does not fit the reveal.
33
 
34
- ## Keep the shot consistent
 
 
 
35
 
36
- Match the source image's motion and setting. A stationary object stays on its support; a moving vehicle keeps traveling, with its detached parts traveling alongside it.
37
 
38
- Choose one camera movement. Use a fixed view when there is already room for the reveal, a gentle pullback when the parts need more space, or a tracking shot for a moving subject. Request an orbit only when you want one. Keep the source lighting consistent.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
39
 
40
- Audio is optional. Add a short final sentence for sound effects, ambience, music, or dialogue; put spoken words in quotation marks. For example: “Soft mechanical clicks accompany the separation over quiet room ambience.” Audio wording can influence the action, so check the picture and sound together. See [LTX's prompting guide](https://ltx.io/blog/ltx-2-5-prompt-guide) for more audio examples.
41
 
42
  ## When the result needs work
43
 
@@ -52,10 +82,9 @@ Audio is optional. Add a short final sentence for sound effects, ambience, music
52
 
53
  Change one thing at a time. Keep the image, seed, and settings fixed when testing a prompt revision. Watch the whole clip: a good final frame can hide problems during separation. Detailed-looking internals may still be inaccurate.
54
 
55
- <details>
56
- <summary>Qwen prompt builder — copy with your image</summary>
57
 
58
- With an Ollama node, supply the builder below as the instruction template and enter your shot request in **Guidance**. Name the action, BASIC or COMPLEX, the separation direction, and the parts that should separate. For motion throughout the clip, say so explicitly in Guidance and check that Qwen includes it in the generated prompt.
59
 
60
  Example Guidance:
61
 
@@ -66,90 +95,32 @@ Review both motion and separation in the finished clip. If your assistant has no
66
  ```text
67
  Write one LTX 2.5 image-to-video prompt for the XPLDV exploded-view LoRA.
68
 
69
- Inspect the supplied image. Identify the target subject, its current motion or
70
- support, the exterior components that should detach, the desired internal
71
- reveal, the structure that stays assembled, appropriate movement paths, camera
72
- framing and lighting continuity. Follow the shot request supplied in Guidance,
73
- including its action, mode, and named parts.
74
-
75
- Before writing the final prompt, privately plan five major assemblies or
76
- reveal stages based on the subject's construction. Identify the outer parts
77
- that detach, the deeper components revealed beneath them, and which internal
78
- mechanisms remain intact. Plan how each layer moves or becomes exposed, using
79
- the natural exterior-to-interior, front-to-back, or top-to-bottom order of the
80
- subject. Focus on large, visually meaningful assemblies and group related
81
- internal components when they belong together. This hierarchy guides the
82
- reveal; it does not require five detached pieces or a fixed animation
83
- sequence. Do not output the plan.
84
-
85
- Use BASIC for quick readable separation with a short list of named internal
86
- components. A COMPLEX prompt guides a more detailed, cinematic reveal through
87
- successive layers, describing deeper internal components, their appearance,
88
- and their positions, including details hidden or difficult to see in the
89
- starting image. These descriptions give LTX 2.5 the information needed to
90
- construct the intended reveal beyond what the image alone shows. Honor the
91
- requested mode; if none is specified, start with BASIC.
92
 
93
  BASIC TEMPLATE:
94
- [SUBJECT] separates into an ordered exploded view. [NAMED OUTER PARTS] move
95
- outward along controlled paths, revealing [NAMED INTERNAL COMPONENTS]
96
- underneath. The parts settle into an organized [LAYERED / RADIAL] arrangement
97
- around [EXPOSED CORE] while retaining their original shapes. [CAMERA
98
- BEHAVIOR]. [LIGHTING CONSISTENT WITH THE IMAGE] remains consistent throughout
99
- the continuous shot.
100
 
101
  COMPLEX TEMPLATE:
102
- [SUBJECT] separates into an ordered exploded view while [CONTINUING ACTION OR
103
- ANCHORED SUPPORT]. [OUTER PART A] detaches and translates [DIRECTION], keeping
104
- [ORIENTATION]. [OUTER PART B] moves [DISTINCT PATH], and [OTHER OUTER PARTS]
105
- move [PATHS]. These exterior parts move first and travel furthest, leaving
106
- clear gaps. They reveal [SPECIFIC COMPONENT AND RECOGNIZABLE FEATURES] at
107
- [POSITION RELATIVE TO THE OBJECT], with [OTHER COMPONENTS AND THEIR
108
- LOCATIONS]. [CORE COMPONENTS] remain mounted together. Each detached section
109
- retains its shape as the arrangement settles and holds steady. [CAMERA
110
- BEHAVIOR]. [CONSISTENT LIGHTING] continues through one continuous shot.
111
-
112
- Adapt the chosen template to the actual image. Replace every placeholder with
113
- concrete wording. Keep BASIC concise. In COMPLEX, describe the successive
114
- layers, their appearance and positions, and the movement paths that expose
115
- them. Keep related parts within a named internal mechanism intact only when
116
- useful; this does not keep exterior panels attached. Describe which internal
117
- layers also move, and omit the sentence about components remaining mounted
118
- together when it does not fit the reveal. Add small parts only when they
119
- matter to the requested reveal. Do not require the same component to stay
120
- attached and detach independently. When full separation is requested, describe
121
- the part coming free of its attachments and remaining suspended with a visible
122
- gap; opening on a hinge is not full separation.
123
-
124
- Preserve continuing motion when requested or clearly part of the intended
125
- shot, with the separated components traveling with the subject. Keep that
126
- action throughout the shot, including the final arrangement. Holding the
127
- arrangement steady means keeping the gaps steady relative to the moving
128
- subject. Keep stationary subjects on their support. Choose one camera behavior
129
- with enough room for the expanded arrangement and retain the source lighting.
130
-
131
- Describe clear spatial and assembly relationships. Use the selected template
132
- to describe the final arrangement. Keep "separates into an ordered exploded
133
- view" as the default opening; use "separates into individual components" when
134
- requested or testing that alternative. Match the arrangement to the paths: a
135
- vertical stack, horizontal row, or radial arrangement around the core. Adapt
136
- the exterior-first timing when a different sequence is requested. Keep every
137
- major part requested in Guidance; do not substitute smaller decorative details
138
- for it.
139
-
140
- When audio is requested, append a concise final sentence describing the
141
- desired sound effects, ambience, music or dialogue. Quote spoken dialogue.
142
- Match the audio to the intended visual action, recognizing that audio wording
143
- may influence that action. When audio is not requested, omit this optional
144
- sentence.
145
-
146
- Do not add destruction, reassembly, an orbit, a negative-prompt list or
147
- unrequested scene changes by default. Do not invent a required trigger token.
148
- Do not promise perfect part counts, background isolation or accurate hidden
149
- construction.
150
-
151
- Return only the completed positive prompt as one continuous paragraph, without
152
- headings, alternatives, placeholders or explanations.
153
  ```
154
 
155
- </details>
 
1
  # Prompting XPLDV
2
 
3
+ Start with **“separates into an ordered exploded view.”** Choose a [BASIC or COMPLEX template](README.md#prompting), then use the slot reference below to fill it.
4
 
5
+ ## Build the reveal
6
 
7
+ ### Filling the slots
8
 
9
+ Grouped names share an explanation. Fill only the slots in your chosen template, giving each part its own details, then write the finished prompt as one paragraph.
10
 
11
+ | Slot | What goes in it |
12
+ | --- | --- |
13
+ | `[SUBJECT]` | The thing being taken apart: “the black SUV.” |
14
+ | `[NAMED OUTER PARTS]`<br>`[OUTER PART A]`<br>`[OUTER PART B]`<br>`[OTHER OUTER PARTS]` | Outside pieces to detach: “hood, front bumper, fenders.” Use the individual part slots when filling COMPLEX. |
15
+ | `[NAMED INTERNAL COMPONENTS]` | Inside parts to reveal: “engine, radiator, and front seats.” |
16
+ | `[LAYERED / RADIAL]` | Stacked layers or parts around a center. Example: “radial.” |
17
+ | `[EXPOSED CORE]` | The center the parts surround: “the moving chassis.” |
18
+ | `[CAMERA BEHAVIOR]` | One camera action with room for all the parts: “The camera tracks alongside at matching speed.” |
19
+ | `[LIGHTING CONSISTENT WITH THE IMAGE]`<br>`[CONSISTENT LIGHTING]` | The light already in the image: “the warm street lighting.” |
20
+ | `[CONTINUING ACTION OR ANCHORED SUPPORT]` | What the subject keeps doing or rests on: “driving across the bridge.” |
21
+ | `[DIRECTION]`<br>`[DISTINCT PATH]`<br>`[PATHS]` | Each part's movement path: “hood straight upward; bumper forward.” Give each part its own path. |
22
+ | `[ORIENTATION]` | How it stays angled: “flat and horizontal.” |
23
+ | `[SPECIFIC COMPONENT AND RECOGNIZABLE FEATURES]` | An internal part and its appearance: “a V8 engine with exposed intake pipes.” |
24
+ | `[POSITION RELATIVE TO THE OBJECT]` | Where that part belongs: “ahead of the cabin.” |
25
+ | `[OTHER COMPONENTS AND THEIR LOCATIONS]` | Other revealed assemblies and their positions: “brake discs inside the wheels.” |
26
+ | `[CORE COMPONENTS]` | Parts to keep assembled: “the engine and transmission.” Omit this clause if those parts should separate too. |
27
 
28
+ ## Keep the shot consistent
29
 
30
+ State ongoing motion separately from separation: the vehicle keeps driving, its wheels keep rotating, and the detached parts keep traveling with it after the gaps stop increasing. Keep stationary subjects on their support.
 
 
 
31
 
32
+ Match the paths to the final arrangement: vertically apart for a stack, sideways for a row, or outward around the core for a radial spread. Describe one consistent order, whether parts separate together or in stages. Detached parts should keep their shapes and remain suspended with visible gaps.
33
 
34
+ **Optional additions**
 
 
 
 
35
 
36
+ - **Preservation:** Name existing people, objects, or surroundings that should stay consistent. For example: “The driver remains seated and the bridge stays intact.” These are preservation requests, not guaranteed locks.
37
+ - **Audio:** With audio generation enabled, add one final sentence for sound effects, ambience, music, or dialogue. Put spoken dialogue in quotation marks. Audio wording can influence the visible action, so review picture and sound together. See [LTX's prompting guide](https://ltx.io/blog/ltx-2-5-prompt-guide) for examples.
38
 
39
+ ## First and last frame guidance
40
 
41
+ XPLDV also works well with first/last-frame generation. **For this setup, use XPLDV as motion guidance between the two endpoint images.** The first image establishes the assembled subject; the last image defines the intended exploded arrangement. XPLDV encourages ordered component separation during the movement between them.
42
 
43
+ 1. **Prepare a compatible image pair.** Keep the same subject, identifiable parts, materials, and lighting. Give the last image clear gaps between components and enough room for the full arrangement. Any change in viewpoint should fit the camera movement you request.
44
+ 2. **Use a workflow that accepts both guides.** The tested ComfyUI setup uses `LTXVAddGuide` at frame `0` and frame `-1`, with both guides applied in each sampling pass. The included release workflow is a single-image example; it needs a first/last-frame variant for this setup.
45
+ 3. **Describe the movement between the images.** Use the existing BASIC or COMPLEX structure. Name the parts, their detachment paths, what becomes visible, and what continues moving. Write a consistent route to the supplied final arrangement.
46
+ 4. **Review the whole transition.** Check component identity, detachment, and continuous movement between the endpoints. A matching last frame alone does not establish a clean exploded-view animation.
47
 
48
+ An end image can strongly determine the final geometry. To judge XPLDV's contribution, compare the movement between endpoints with the LoRA enabled and disabled while keeping both images, prompt, seed, and sampling settings fixed.
49
 
50
+ <details>
51
+ <summary>Tested first/last-frame settings</summary>
52
+
53
+ The burger and running-shoe tests used the following settings. These record the successful guided tests; **0.5 remains the general starting LoRA strength for a new subject**.
54
+
55
+ | Setting | Tested value |
56
+ | --- | --- |
57
+ | Model | LTX-2.5 distilled BF16 |
58
+ | XPLDV | Released step 3000 weights, strength 0.7 in both passes |
59
+ | First and last image guides | Strength 1.0 at frame 0 and frame -1 in both passes |
60
+ | Duration | 145 frames at 24 FPS, approximately 6 seconds |
61
+ | First pass | 960 x 544; Euler ancestral; 8 steps |
62
+ | First-pass manual sigmas | `1.0, 0.99375, 0.9875, 0.98125, 0.975, 0.909375, 0.725, 0.421875, 0.0` |
63
+ | Second pass | 1920 x 1088; Euler; 3 steps |
64
+ | Second-pass manual sigmas | `0.85, 0.7250, 0.4219, 0.0` |
65
+ | CFG and seed | CFG 1 and seed 42 in both passes |
66
+ | Text conditioning | Direct prompt, enhancement off, empty negative prompt |
67
+
68
+ LoRA strength and image-guide strength are separate controls. Keep both passes consistent when comparing LoRA strengths. Review each new image pair; the tested strength is not a guarantee of better quality for another subject.
69
 
70
+ </details>
71
 
72
  ## When the result needs work
73
 
 
82
 
83
  Change one thing at a time. Keep the image, seed, and settings fixed when testing a prompt revision. Watch the whole clip: a good final frame can hide problems during separation. Detailed-looking internals may still be inaccurate.
84
 
85
+ ## Qwen prompt builder — copy with your image
 
86
 
87
+ With an Ollama node, supply the image and put the builder below in the connected **Instruction Template** input. **Guidance** is optional: leave it blank for BASIC or enter **Complex** for a detailed reveal. Use Guidance to specify a particular subject, action, arrangement, or parts. Start a fresh conversation for each independent image. For motion throughout the clip, say so explicitly in Guidance and check that Qwen includes it in the generated prompt.
88
 
89
  Example Guidance:
90
 
 
95
  ```text
96
  Write one LTX 2.5 image-to-video prompt for the XPLDV exploded-view LoRA.
97
 
98
+ Inspect the whole image and decide what physical construction the scene represents before naming parts. Choose the subject from the overall composition, not a prominent label or logo on one component. When a scene is built inside a larger machine or structure, use that enclosing construction as the subject and include its major visible levels; do not reduce the effect to a smaller object nested inside it. For a self-contained product on a table or in a presentation box, use the product itself; unrelated packaging and display props are not part of its construction. An explicit target or exclusion in Guidance overrides this default. State the chosen scope clearly in the opening sentence and keep every layer and internal reveal within that scope, preserving the relative scale and positions of its parts.
99
+
100
+ Identify the subject's current motion or support, the exterior components that should detach, the desired internal reveal, the structure that stays assembled, appropriate movement paths, camera framing and lighting continuity. Use only the current image and shot request; do not carry subject restrictions or scene actions over from earlier requests. Follow Guidance for the action, mode, and named parts. Preserve the people and loose props while following any requested action. Where people or furniture need support, identify the load-bearing surface that stays in place and separate removable sections around it. Do not detach that same support elsewhere in the prompt.
101
+
102
+ Before writing the final prompt, privately plan five major assemblies or reveal stages based on the subject's construction. Identify the outer parts that detach, the deeper components revealed beneath them, and which internal mechanisms remain intact. Plan how each layer moves or becomes exposed, using the natural exterior-to-interior, front-to-back, or top-to-bottom order of the subject. Focus on large, visually meaningful assemblies and group related internal components when they belong together. This hierarchy guides the reveal; it does not require five detached pieces or a fixed animation sequence. Do not output the plan.
103
+
104
+ Use BASIC for quick readable separation with a short list of named internal components. A COMPLEX prompt guides a more detailed, cinematic reveal through successive layers, describing deeper internal components, their appearance, and their positions, including details hidden or difficult to see in the starting image. These descriptions give LTX 2.5 the information needed to construct the intended reveal beyond what the image alone shows. Honor the requested mode; if none is specified, start with BASIC.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
105
 
106
  BASIC TEMPLATE:
107
+ [SUBJECT] separates into an ordered exploded view. [NAMED OUTER PARTS] move outward along controlled paths, revealing [NAMED INTERNAL COMPONENTS] underneath. The parts settle into an organized [LAYERED / RADIAL] arrangement around [EXPOSED CORE] while retaining their original shapes. [CAMERA BEHAVIOR]. [LIGHTING CONSISTENT WITH THE IMAGE] remains consistent throughout the continuous shot.
 
 
 
 
 
108
 
109
  COMPLEX TEMPLATE:
110
+ [SUBJECT] separates into an ordered exploded view while [CONTINUING ACTION OR ANCHORED SUPPORT]. [OUTER PART A] detaches and translates [DIRECTION], keeping [ORIENTATION]. [OUTER PART B] moves [DISTINCT PATH], and [OTHER OUTER PARTS] move [PATHS]. These exterior parts move first and travel furthest, leaving clear gaps. They reveal [SPECIFIC COMPONENT AND RECOGNIZABLE FEATURES] at [POSITION RELATIVE TO THE OBJECT], with [OTHER COMPONENTS AND THEIR LOCATIONS]. [CORE COMPONENTS] remain mounted together. Each detached section retains its shape as the arrangement settles and holds steady. [CAMERA BEHAVIOR]. [CONSISTENT LIGHTING] continues through one continuous shot.
111
+
112
+ Adapt the chosen template to the actual image. Replace every placeholder with concrete wording. Keep BASIC concise. In COMPLEX, describe the successive layers, their appearance and positions, and the movement paths that expose them. Keep related parts within a named internal mechanism intact only when useful; this does not keep exterior panels attached. Describe which internal layers also move, and omit the sentence about components remaining mounted together when it does not fit the reveal. Add small parts only when they matter to the requested reveal. Do not require the same component to stay attached and detach independently. When full separation is requested, describe the part coming free of its attachments and remaining suspended with a visible gap; opening on a hinge is not full separation.
113
+
114
+ Preserve continuing motion when requested or clearly part of the intended shot, with the separated components traveling with the subject. Keep that action throughout the shot, including the final arrangement. Holding the arrangement steady means keeping the gaps steady relative to the moving subject. Keep stationary subjects on their support. Choose one camera behavior with enough room for the expanded arrangement and retain the source lighting.
115
+
116
+ Describe clear spatial and assembly relationships. Use the selected template to describe the final arrangement. Keep "separates into an ordered exploded view" as the default opening; use "separates into individual components" when requested or testing that alternative. Match the arrangement to the paths: a vertical stack, horizontal row, or radial arrangement around the core. Adapt the exterior-first timing when a different sequence is requested. Keep every major part requested in Guidance; do not substitute smaller decorative details for it.
117
+
118
+ When audio is requested, append a concise final sentence describing the desired sound effects, ambience, music or dialogue. Quote spoken dialogue. Match the audio to the intended visual action, recognizing that audio wording may influence that action. When audio is not requested, omit this optional sentence.
119
+
120
+ Do not add destruction, reassembly, an orbit, a negative-prompt list or unrequested scene changes by default. Do not invent a required trigger token. Do not promise perfect part counts, background isolation or accurate hidden construction.
121
+
122
+ Before returning, check that the completed prompt keeps the chosen subject and scope throughout, that no supporting part is described as both fixed and moving, and that separated parts remain suspended. Correct any conflicts silently.
123
+
124
+ Return only the completed positive prompt as one continuous paragraph, without headings, alternatives, placeholders or explanations.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
125
  ```
126