50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
# MultiPromptNode
|
||
|
||
`MultiPromptNode` cycles through a list of prompt variants, blending each option with a weight. It’s a fast way to explore phrasing tweaks or maintain a rotating pool of detail prompts without editing text nodes manually.
|
||
|
||
---
|
||
|
||
## Inputs
|
||
- `seed` – Optional number to lock the random order. Leave at `0` to use the global seed.
|
||
- `prompts` – List of prompt strings. Each entry corresponds to a slot in the UI.
|
||
- `weights` – Matching list of weights; higher numbers make that prompt more likely to appear.
|
||
- `mode` – Choose how the node selects variants:
|
||
- `Cycle` walks through the list in order.
|
||
- `Random` picks based on weight distribution.
|
||
- `Shuffle` seeds a random order once, then cycles through it.
|
||
- `fallback_prompt` – Used when all prompts are blank or disabled.
|
||
|
||
Slots can be enabled or disabled individually from the widget panel.
|
||
|
||
---
|
||
|
||
## Outputs
|
||
- `prompt` – The selected prompt string ready for downstream text-to-image nodes.
|
||
- `index` – Slot number that triggered this run (useful for logging).
|
||
|
||
---
|
||
|
||
## Where It Fits
|
||
|
||
Use MultiPromptNode when iterating around a core idea—e.g., alternating between lighting descriptions, swapping wardrobe notes, or rotating through portrait adjectives while keeping the base prompt steady.
|
||
|
||
---
|
||
|
||
## Tuning Tips
|
||
|
||
- Set weights to `0` to temporarily mute a slot without removing it.
|
||
- Combine `Cycle` mode with `ComparisonGate` to run predictable A/B/C tests.
|
||
- Use `Random` with a fixed seed when you want reproducible randomness across multiple runs.
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
- **Same prompt repeats** – Check that `mode` is set to the behaviour you expect and that weights aren’t skewed heavily toward one slot.
|
||
- **Output is empty** – Make sure at least one prompt slot contains text or set a `fallback_prompt`.
|
||
- **Order resets unexpectedly** – When using `Shuffle`, keep the seed fixed; changing it generates a new permutation.
|
||
|
||
---
|
||
|
||
Screenshot: `docs/screenshots/multi_prompt_node.png`
|