Permissão necessária para habilitar o método FindSimilar na Azure Face API?

Question

Olá,

Estou desenvolvendo um aplicativo de teste utilizando a Azure Face API para reconhecimento facial. A implementação deste app tem como objetivo encontrar fotos em uma galeria previamente adicionada à Face API, utilizando uma selfie enviada pelo usuário.

Atualmente, já implementei as funcionalidades de detecção, verificação e identificação, e já solicitei as seguintes permissões via formulário (https://aka.ms/facerecognition):

1. [Face API] Facial Verification (1:1 matching) with optional facial liveness detection for identity verification to grant access to digital or physical services or spaces.
2. [Face API] Facial Identification (1:N or 1:1 matching) with optional facial liveness detection to detect duplicate or blocked users to control or prevent unauthorized access to digital or physical services or spaces.

No entanto, ao tentar utilizar o método FindSimilar para comparar a selfie do usuário com os rostos cadastrados na galeria, recebo o erro "Forbidden" com a mensagem "Invalid request has been sent."

Gostaria de saber:

• Existe alguma outra permissão ou configuração específica que preciso solicitar ou habilitar para utilizar o método FindSimilar com sucesso?
• Há alguma configuração adicional na Face API ou na minha conta do Azure que deva ser ajustada para que esse método funcione sem retornar erros de "Forbidden"?

Agradeço antecipadamente pela ajuda e orientação para que eu possa finalizar o desenvolvimento do meu aplicativo com sucesso.

Answer 1

Olá Evanoel Tavares,

Bem-vindo ao Mircosoft Q&A!

Para resolver o problema que você está enfrentando com o método FindSimilar da Azure Face API, aqui estão algumas considerações detalhadas e passos que você pode seguir:

1. Permissões e Configurações Necessárias

Permissões

Você já solicitou permissões importantes, mas é possível que ainda falte alguma permissão específica para o método FindSimilar. A mensagem de erro "Forbidden" geralmente indica que a sua conta não tem as permissões necessárias para executar a operação. Certifique-se de que você tenha solicitado e recebido aprovação para todas as permissões relacionadas ao uso da Face API, especialmente para operações de identificação e verificação facial

Configurações na Face API

Verifique se você está utilizando a chave de assinatura correta e o endpoint apropriado para a sua região. Um erro comum é usar uma chave ou endpoint incorreto, o que pode resultar em erros de autorização

2. Configurações Adicionais na Conta do Azure

Verificação de Subscrição

Certifique-se de que a sua subscrição do Azure está ativa e que você tem créditos suficientes para utilizar a Face API. Além disso, verifique se a subscrição está configurada para permitir o uso de serviços cognitivos, incluindo a Face API

Configuração do Endpoint

Garanta que o endpoint que você está utilizando corresponde à região onde a Face API foi provisionada. Por exemplo, se a Face API foi provisionada na região "westus", o endpoint deve ser algo como https://<seu-recurso>.cognitiveservices.azure.com/face/v1.0

3. Exemplos de Código e Configurações

Aqui está um exemplo de como configurar corretamente o cliente da Face API em C#:

public static IFaceClient Authenticate(string endpoint, string key)
{
    return new FaceClient(new ApiKeyServiceClientCredentials(key)) { Endpoint = endpoint };
}

IFaceClient client = Authenticate("https://<seu-recurso>.cognitiveservices.azure.com/", "<sua-chave>");

E um exemplo de como utilizar o método FindSimilar:

var faceId = "<faceId-da-selfie>";
var faceIds = new List<string> { "<faceId1>", "<faceId2>", "<faceId3>" };

var similarFaces = await client.Face.FindSimilarAsync(faceId, faceIds);

Caso necessite das informações e recursos utilizados como referência: Documentação da Azure Face API, Códigos de Erro da Face API, Microsoft Q&A sobre Erros da Face API.

Espero que essas informações ajudem a resolver o problema que você está enfrentando. Se precisar de mais assistência, estou à disposição!

Saudações

Gao.

---

Se esta resposta resolveu sua consulta, por favor clique em 'Aceitar resposta'. Isso nos ajuda a melhorar continuamente a qualidade e relevância de nossas soluções.