Actions17
Addon → Search by Face
AI-generatedSummary
Search for assets that contain a specific face using an indexed face image.
Inputs
- faceSearchBinaryProperty (required) — Name of the binary property containing the face image. Use an HTTP Request node to download the image first.
- faceSearchStrictness — Matching strictness from 0 (loose) to 10 (exact). Higher = fewer but more accurate matches.
- faceSearchExtended — If true, return full asset data for each match (not just IDs).
- faceSearchFilters — Optional JSON string of metadata field filters. Fields are ANDed, space-separated values are ORed.
- faceSearchLimit — Number of results per page (1-30).
Output shape
Array of objects each containing match metadata (matches, hits, searchId, page, extendedResult, etc.).
Pagination applies; extendedResult may be null; hits shows total matches; results are returned as JSON objects.
Examples
Example 1: Find assets matching a face stored in the 'data' binary property.
faceSearchBinaryProperty=data, faceSearchStrictness=9.9, faceSearchExtended=true, faceSearchLimit=10