ComfyUI Node
Face Identify (ArcFace)
Identifies every face in an image against reference folders and returns per-face crops and labels as lists.
Face Identify (ArcFace)
- image
- face_analysis
- face_crop
- label
- score
- runner_up
- runner_up_score
- suffix
- subfolder
- crop_box_json
- restore_json
- summary_json
- mirror_dir
- stem
- save_dir
◄reference_folderdataset/_references►
◄threshold0.40►
◄margin0.05►
◄aggregatemax►
◄unknown_labelunknown►
◄crop_pad1.60►
◄providerauto►
◄source—►
◄mirror_dir—►
◄stem—►
◄suffix_extra►
Category🎨 DockerCPU API/Face
Inputs (13)
| Name | Type | Default | Description |
|---|---|---|---|
| image | IMAGE | — | |
| face_analysis | FACE_ANALYSIS | — | |
| reference_folder | STRING | dataset/_references | Relative to the input folder, or absolute. Subfolder name = label. |
| threshold | FLOAT | 0.40-1–1 | Minimum best score to assign a label. |
| margin | FLOAT | 0.050–2 | Best minus runner-up (a different label) must reach this. |
| aggregate | COMBO | max | How one label's reference scores combine. |
| unknown_label | STRING | unknown | — |
| crop_pad | FLOAT | 1.601–8 | Square crop side = max(bbox w, h) x crop_pad, native resolution. |
| provider | COMBO | auto | Used when embedding reference images. |
| sourceopt | STRING | Source image path for restore_json, e.g. REL_DIR/BASE_FILENAME. | |
| mirror_diropt | STRING | This image's MIRROR_DIR, repeated per face so batch saves pair correctly. | |
| stemopt | STRING | This image's STEM, repeated per face. | |
| suffix_extraopt | STRING | Appended to each suffix, e.g. _head -> _p01_head. |
Outputs (13)
| Name | Type | Description |
|---|---|---|
| face_crop | IMAGE | — |
| label | STRING | — |
| score | FLOAT | — |
| runner_up | STRING | — |
| runner_up_score | FLOAT | — |
| suffix | STRING | — |
| subfolder | STRING | — |
| crop_box_json | STRING | — |
| restore_json | STRING | — |
| summary_json | STRING | — |
| mirror_dir | STRING | — |
| stem | STRING | — |
| save_dir | STRING | — |