DetectFaces - 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á.

DetectFaces

Detecta faces em uma imagem fornecida como entrada.

DetectFacesO detecta as 100 faces maiores da imagem. Para cada face detectada, a operação retorna os detalhes do rosto. Esses detalhes incluem uma caixa delimitadora do rosto, um valor de confiança (que a caixa delimitadora contém um rosto) e um conjunto fixo de atributos, como marcos faciais (por exemplo, coordenadas de olho e boca), presença de barba, óculos de sol e assim por diante.

O algoritmo de detecção facial é mais eficaz em faces frontais. Para faces não frontais ou obscurecidas, o algoritmo pode não detectar as faces ou detectar faces com menor confiança.

Você passa a imagem de entrada como bytes de imagem codificados em base64 ou como referência a uma imagem em um bucket do Amazon S3. Se você usar a AWS CLI para chamar operações do Amazon Rekognition, não será oferecido o suporte à passagem de bytes da imagem. A imagem deve ser um arquivo em formato PNG ou JPEG formatado.

nota

Esta é uma operação de API sem estado. Ou seja, a operação não persiste nenhum dado.

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

Sintaxe da solicitação

{ "Attributes": [ "string" ], "Image": { "Bytes": blob, "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } } }

Parâmetros de solicitação

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

Attributes

Uma matriz de atributos faciais que você deseja retornar. Essa pode ser a lista padrão de atributos ou todos os atributos. Se você não especifica um valor paraAttributesou se você especificar["DEFAULT"], a API retorna o seguinte subconjunto de atributos faciais:BoundingBox,Confidence,Pose,Quality, eLandmarks. Se você fornecer["ALL"], todos os atributos faciais são retornados, mas a operação leva mais tempo para ser concluída.

Se você fornecer ambos,["ALL", "DEFAULT"], o serviço usa um operador AND lógico para determinar quais atributos retornar (neste caso, todos os atributos).

Type: Matriz de strings

Valores válidos: DEFAULT | ALL

: obrigatório Não

Image

A imagem de entrada como bytes codificados em base64 ou um objeto S3. Se você usar a AWS CLI para chamar operações do Amazon Rekognition, não será oferecido o suporte à passagem de bytes de imagem codificados em base64.

Se você estiver usando um AWS SDK para chamar o Amazon Rekognition, talvez não seja necessário codificar bytes de imagem com base 64 passados usando oBytescampo. Para obter mais informações, consulte Especificações.

Tipo: objeto Image

: obrigatório Sim

Sintaxe da resposta

{ "FaceDetails": [ { "AgeRange": { "High": number, "Low": number }, "Beard": { "Confidence": number, "Value": boolean }, "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Confidence": number, "Emotions": [ { "Confidence": number, "Type": "string" } ], "Eyeglasses": { "Confidence": number, "Value": boolean }, "EyesOpen": { "Confidence": number, "Value": boolean }, "Gender": { "Confidence": number, "Value": "string" }, "Landmarks": [ { "Type": "string", "X": number, "Y": number } ], "MouthOpen": { "Confidence": number, "Value": boolean }, "Mustache": { "Confidence": number, "Value": boolean }, "Pose": { "Pitch": number, "Roll": number, "Yaw": number }, "Quality": { "Brightness": number, "Sharpness": number }, "Smile": { "Confidence": number, "Value": boolean }, "Sunglasses": { "Confidence": number, "Value": boolean } } ], "OrientationCorrection": "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.

FaceDetails

Detalhes de cada face encontrada na imagem.

Type: Matriz deFaceDetailobjetos

OrientationCorrection

O valor deOrientationCorrectioné sempre nulo.

Se a imagem de entrada estiver no formato.jpeg, ela poderá conter metadados em formato Exif. O Amazon Rekognition usa essas informações de orientação para executar a correção de imagem. As coordenadas da caixa delimitadora são traduzidas para representar locais do objeto após as informações de orientação nos metadados Exif serem usadas para corrigir a orientação da imagem. As imagens em formato .png não contêm metadados do Exif.

O Amazon Rekognition não executa correção de imagem para imagens no formato.png e imagens.jpeg sem informações de orientação nos metadados Exif da imagem. As coordenadas da caixa delimitadora não são traduzidas e representam os locais do objeto antes que a imagem seja girada.

Type: String

Valores válidos: ROTATE_0 | ROTATE_90 | ROTATE_180 | ROTATE_270

Errors

AccessDeniedException

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

Código de status HTTP: 400

ImageTooLargeException

O tamanho da imagem de entrada excede o limite permitido. Se você estiver ligandoDetectProtectiveEquipment, O tamanho ou a resolução da imagem excede o limite permitido. Para obter mais informações, consulte Diretrizes e cotas no Amazon Rekognition.

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

InvalidImageFormatException

O formato da imagem fornecida não é compatível.

Código de status HTTP: 400

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

InvalidS3ObjectException

O Amazon Rekognition não pode acessar o objeto do S3 especificado na solicitação.

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

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: