Amazon Rekognition Search Faces By Image Request Structure

SearchFacesByImageRequest schema from Amazon Rekognition

Type: object Properties: 5 Required: 2

Celebrity RecognitionComputer VisionContent ModerationCustom LabelsDeep LearningFace LivenessFacial RecognitionImage AnalysisMachine LearningObject DetectionText DetectionVideo Analysis

SearchFacesByImageRequest is a JSON Structure definition published by Amazon Rekognition, describing 5 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

CollectionId Image MaxFaces FaceMatchThreshold QualityFilter

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-rekognition/refs/heads/main/json-structure/amazon-rekognition-search-faces-by-image-request-structure.json",
  "name": "SearchFacesByImageRequest",
  "description": "SearchFacesByImageRequest schema from Amazon Rekognition",
  "type": "object",
  "properties": {
    "CollectionId": {
      "type": "string",
      "example": "my-face-collection"
    },
    "Image": {
      "$ref": "#/components/schemas/Image"
    },
    "MaxFaces": {
      "type": "int32",
      "example": 5
    },
    "FaceMatchThreshold": {
      "type": "float",
      "example": 80.0
    },
    "QualityFilter": {
      "type": "string",
      "enum": [
        "NONE",
        "AUTO",
        "LOW",
        "MEDIUM",
        "HIGH"
      ]
    }
  },
  "required": [
    "CollectionId",
    "Image"
  ]
}