SearchFaces - Amazon Rekognition

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

SearchFaces

Para uma determinada ID de face de entrada, pesquisa faces correspondentes na coleção à qual a face pertence. Você obtém um ID de face ao adicionar um rosto à coleção usando oIndexFacesoperação. A operação compara os recursos da face de entrada com faces na coleção especificada.

nota

Você também pode pesquisar rostos sem indexar faces usando oSearchFacesByImageoperação.

A resposta da operação retorna uma matriz de faces que correspondem, ordenadas pela pontuação de similaridade com a maior semelhança primeiro. Mais especificamente, é uma matriz de metadados para cada correspondência facial encontrada. Junto com os metadados, a resposta também inclui umconfidencevalor para cada correspondência de face, indicando a confiança de que a face específica corresponde à face de entrada.

Para ver um exemplo, consulte Procurando por um rosto usando seu ID facial.

Essa operação exige permissões para executar a ação rekognition:SearchFaces.

Sintaxe da solicitação

{ "CollectionId": "string", "FaceId": "string", "FaceMatchThreshold": number, "MaxFaces": number }

Parâmetros de solicitação

A solicitação aceita os dados a seguir no formato JSON.

CollectionId

ID da coleção à qual o rosto pertence.

Type: String

Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 255.

Padrão: [a-zA-Z0-9_.\-]+

: obrigatório Sim

FaceId

ID de um rosto para encontrar correspondências na coleção.

Type: String

Padrão: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

: obrigatório Sim

FaceMatchThreshold

Valor opcional especificando a confiança mínima na correspondência facial para retornar. Por exemplo, não retorne nenhuma correspondência em que a confiança nas partidas seja inferior a 70%. O valor padrão é 80%.

Type: Float

Intervalo válido Valor mínimo de 0. Valor máximo de 100.

: obrigatório Não

MaxFaces

O número máximo de faces a serem retornadas. A operação retorna o número máximo de faces com a maior confiança na partida.

Type: Inteiro

Intervalo válido Valor mínimo de 1. Valor máximo de 4096.

: obrigatório Não

Sintaxe da resposta

{ "FaceMatches": [ { "Face": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Confidence": number, "ExternalImageId": "string", "FaceId": "string", "ImageId": "string" }, "Similarity": number } ], "FaceModelVersion": "string", "SearchedFaceId": "string" }

Elementos de resposta

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

FaceMatches

Uma matriz de faces que correspondia à face de entrada, juntamente com a confiança na partida.

Type: Matriz deFaceMatchobjetos

FaceModelVersion

O número da versão do modelo de detecção de faces associado à coleção de entrada (CollectionId).

Type: String

SearchedFaceId

ID do rosto que foi pesquisado por correspondências em uma coleção.

Type: String

Padrão: [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Errors

AccessDeniedException

Você não está autorizado a executar a ação.

Código de status HTTP: 400

InternalServerError

O Amazon Rekognition teve um problema de serviço. Tente fazer a chamada novamente.

Código de status HTTP: 500

InvalidParameterException

Um parâmetro de entrada violou uma restrição. Valide seu parâmetro antes de chamar a operação de API novamente.

Código de status HTTP: 400

ProvisionedThroughputExceededException

O número de solicitações excedeu o limite da taxa de transferência. Se precisar aumentar esse limite, entre em contato com o Amazon Rekognition.

Código de status HTTP: 400

ResourceNotFoundException

O recurso especificado na solicitação não pode ser encontrado.

Código de status HTTP: 400

ThrottlingException

O Amazon Rekognition está temporariamente indisponível para processar a solicitação. Tente fazer a chamada novamente.

Código de status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: