34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
# FunPack StoryMem Keyframe Extractor
|
|
|
|
This node extracts representative keyframes from a video batch using CLIP Vision similarity, with optional HPSv3 quality filtering.
|
|
|
|
## Parameters
|
|
|
|
**frames**: Input frame batch in ComfyUI `IMAGE` format.
|
|
|
|
**clip_vision**: CLIP Vision model from your ComfyUI `models/clip_vision` folder.
|
|
|
|
**max_keyframes**: Maximum number of keyframes to return.
|
|
|
|
**similarity_threshold**: Similarity cutoff used when deciding whether a frame is different enough from the previous keyframe. Lower values usually keep more frames.
|
|
|
|
**use_quality_filter**: If enabled, the node also filters frames using HPSv3 quality scoring.
|
|
|
|
**quality_threshold**: Minimum HPSv3 score accepted when quality filtering is enabled.
|
|
|
|
**memory_frames**: Optional earlier keyframes to compare against so near-duplicates can be skipped.
|
|
|
|
## Outputs
|
|
|
|
**keyframes**: Extracted keyframes as an image batch.
|
|
|
|
**keyframe_count**: Number of frames returned in the `keyframes` output.
|
|
|
|
## Purpose
|
|
|
|
Use this node to distill a longer clip into a few representative frames for StoryMem, continuity, or recap workflows.
|
|
|
|
## Notes
|
|
|
|
HPSv3 is optional and is only used when `use_quality_filter` is enabled and the package is installed.
|