H3 Draft Sampler:
H3DraftSampler creates an early visual draft of an H3 sampling run so you can review the result before completing the remaining sampling steps. It works with an existing advanced-sampler setup, including externally prepared H3 conditioning, references or keyframes, and CFG settings, rather than encoding an input image itself. The preview is produced as an x0 estimate: an image estimate made from the sampling progress so far. The node also preserves a draft state for a later continuation and provides a report to help you inspect the preview. Its documented resumable sampling method is native Euler without churn, so do not assume other sampling methods can be resumed in the same way.
H3 Draft Sampler Input Parameters:
noise
A required NOISE connection from your sampling setup. It supplies the noise used when the draft sampling run begins, so connect the same noise source you intend to use with the corresponding advanced sampler. The source does not specify a numeric setting or default for this connection.
guider
A required GUIDER connection that carries the prepared guidance for sampling. Connect the guider from your existing advanced-sampler setup so the draft follows the conditioning and guidance you have configured there. This node does not expose separate controls for H3 conditioning or CFG; those must be prepared externally. No default or selectable options are specified here.
sampler
A required SAMPLER connection that supplies the sampling method. For a draft you intend to continue, use a sampler compatible with the node’s documented resumable solver: native Euler without churn. The interface does not list a default sampler or other supported resumable methods.
sigmas
A required SIGMAS connection containing the sampling schedule. The schedule determines the transitions available to the draft, and preview_steps determines how many transitions occur before you review it. Supply a schedule with at least one transition remaining after the preview; the interface does not specify a default schedule.
latent_image
A required LATENT connection providing the starting latent for sampling. Connect the latent you would otherwise supply to the advanced sampler so the draft uses the intended starting point. The node does not encode an input image into a latent, and no default latent is specified.
video_vae
A required VAE connection used by the draft process to produce its image preview. Connect the video VAE appropriate for your existing H3 workflow. The interface does not provide a default or a list of VAE options.
preview_steps
A required integer setting for how many sampling transitions to perform before presenting the draft for review. Its default is 3, its minimum is 1, and its maximum is 999. Choose a value that leaves at least one transition in the supplied SIGMAS schedule: a smaller value gives you an earlier review point, while a larger value advances sampling further before you review it.
H3 Draft Sampler Output Parameters:
preview_image
An IMAGE containing the draft’s x0 preview estimate. Use it to inspect the visual direction reached after the selected number of transitions; it is a review image, not a claim that the remaining sampling steps have been completed. The node clones the preview image from its generated draft state and also presents preview information in the interface.
draft_state
An H3_SAMPLER_DRAFT_STATE containing the saved state of the draft run. This is the output to retain or pass to a compatible continuation workflow when you want to proceed from the review point, rather than treating the preview image as the sampling state.
report
A STRING containing a readable JSON report about the draft run. The node adds preview_diagnostics to the report before returning it. You can inspect this text when reviewing or troubleshooting a draft, but the exact report fields and diagnostic values are determined by the sampling engine and preview backend and are not specified in the provided source.
H3 Draft Sampler Usage Tips:
- Connect
noise,guider,sampler,sigmas, andlatent_imagefrom the setup you would use withSamplerCustomAdvanced. This keeps the draft aligned with your intended sampling workflow. - Start with the default
preview_stepsvalue of3for an early check. Increase it if you want to review a more advanced draft, but leave at least one transition insigmasfor continuation. - If you plan to continue the draft, select native Euler without churn; that is the resumable solver explicitly documented by the node.
- Keep
draft_statefor continuation. Usepreview_imagefor visual review andreportfor written diagnostics; the image alone is not the saved sampling state. - Prepare H3 conditioning, references or keyframes, and CFG in the external workflow before connecting its guider. This node does not expose separate controls for them or encode an input image.
H3 Draft Sampler Common Errors and Solutions:
preview_steps must be at least 1
- Explanation: The node’s allowed minimum is
1sampling transition. This heading describes a possible validation issue, not a confirmed message emitted by the sampling engine. - Solution: Set
preview_stepsto1or greater.
preview_steps must be at most 999
- Explanation: The node’s allowed maximum is
999. This heading describes a possible validation issue, not a confirmed message emitted by the sampling engine. - Solution: Set
preview_stepsto999or less, and also check that yoursigmasschedule leaves a transition after the preview.
Not enough transitions remain in sigmas after preview_steps
- Explanation: The input tooltip states that the preview must leave at least one transition in the supplied schedule. The exact error text, if any, is not shown in the provided source.
- Solution: Lower
preview_stepsor supply a schedule with more transitions. For example, do not set the preview to consume every available transition.
Missing or incompatible required connection
- Explanation:
noise,guider,sampler,sigmas,latent_image, andvideo_vaeare all required connections. A disconnected socket or a connection of the wrong type can prevent the node from running; exact validation messages depend on the host workflow. - Solution: Check that every required socket is connected to an output with its matching type, especially
LATENTforlatent_imageandVAEforvideo_vae.
Draft cannot be continued with the selected sampling method
- Explanation: The node documents native Euler without churn as its current resumable solver. The provided source does not establish continuation support for other methods or show an exact error message.
- Solution: Use a native Euler sampler without churn when you need a resumable draft, and keep its sampling setup consistent for continuation.
Preview creation fails or no preview image appears
- Explanation: The node relies on its sampling engine and preview backend to create and display the image. Their implementations are not provided, so the source does not identify a single confirmed cause or error message.
- Solution: Verify the required connections, use the intended video VAE, and try a valid, smaller
preview_stepsvalue. If the problem persists, consult the host application’s error log for the specific failure.
