Unify Logo Footer.svg
Unify Automations
Logo
Extract Face Embeddings

Extract Face Embeddings

Logo

2 mins READ

Extract Face Embeddings detects faces in an image and returns a numerical vector representation for each one, enabling similarity search, verification, and other face-based ML workflows downstream.

Overview

The Extract Face Embeddings operation is a self-contained ML utility in the Unify AI toolkit. It takes an image as input, identifies any faces present, and generates a compact embedding vector for each detected face. These vectors can then be stored in a vector database, compared against a reference set for recognition, or passed as features into a broader ML pipeline.

The operation produces embeddings only — it does not perform identification itself. Matching or recognition logic must be handled by subsequent pipeline steps that act on the returned vectors.

Screenshot 2026-08-27 at 17.30.57 1.png
Screenshot 2026-08-27 at 17.30.57 1.png

Input

Field

Type

Required

Description

Image

file

Yes

The image in which to detect and embed faces. May contain one or more faces.

Output

Returns an array of face embeddings. Each item in the array corresponds to one detected face and contains the embedding vector for that face. If no faces are detected, the array is empty.

Notes

  • If no faces are detected in the image, the output array will be empty. Handle this case in downstream steps if your automation requires at least one face to proceed.

  • The output embeddings are numerical vectors — they represent facial features but are not human-readable labels or identifiers.

  • Identification or matching logic must be implemented in subsequent pipeline steps using the returned vectors.

  • This operation is self-contained — it does not call a separate model service or depend on other Unify AI operations.

  • For general image format conversion, use Convert Image instead.

FAQs

Does the image need to contain exactly one face?

No. The operation handles images with multiple faces and returns an embedding for each detected face in the output array.

Can this identify who a person is?

No. Extract Face Embeddings produces vectors that represent facial features; the matching or identification step must be implemented separately using those vectors, such as by comparing them against a stored reference set.

What does this operation return if no face is found?

The output array will be empty. Add a conditional step downstream if your automation logic requires at least one face embedding to continue.