Addons - Face Recognition

Face detection, recognition, and search capabilities

📄️ Data Handling

The Face Recognition & Search addon processes facial data using advanced machine learning. This page explains how we handle that data to ensure privacy, security, and compliance.

📄️ Index Faces

Analyse, detect, extract, and index faces in an image. The method requires an `asset_id` in the path parameter to identify the image to analyze. The `POST` method also returns the asset ID of the image that was processed. `409` response indicates that an asset with the provided ID has been already processed.

📄️ Face Index Status

Retrieve the current status of the face indexing request by providing the `asset_id` in the path parameter.

📄️ Face Search

Search for faces in an image. The method requires the `image` parameter to perform the search. The `limit_per_page` parameter is optional and defaults to 30 if not provided. The method returns a list of assets that match the search criteria.

📄️ Paginated Search Results

Retrieve a paginated search result for up to 30 assets per page. The method requires the `page` and `search_id` parameters from the Face Search response to retrieve the results.

📄️ Delete Face Data

Delete all Face Data associated with the provided assets. It will not delete the `_filespin_fr_count` field in Asset Metadata.

📄️ Limitations

The FileSpin Face Recognition & Search addon uses advanced machine learning algorithms to detect, analyze, and match human faces in images. While the technology provides powerful capabilities for face indexing and searching, developers should be aware of inherent limitations in facial recognition technology that may impact accuracy and performance.