Compartilhar via

Códigos de erro da API de Detecção Facial do Azure AI

  • Artigo

Códigos de erro comuns

Esses códigos de erro podem ser retornados por qualquer chamada de API de Detecção Facial.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument O corpo da solicitação é inválido.
Solicitação incorreta (400) BadArgument Erro de análise JSON. Corpo JSON de solicitação inválida ou irreconhecível.
Solicitação incorreta (400) BadArgument O modelo “recognitionModel” é inválido.
Solicitação incorreta (400) BadArgument O modelo “detectionModel” é inválido.
Solicitação incorreta (400) BadArgument 'name' está vazio.
Solicitação incorreta (400) BadArgument 'nome' é muito longo.
Solicitação incorreta (400) BadArgument 'userData' é muito longo.
Solicitação incorreta (400) BadArgument 'start' é muito longo.
Solicitação incorreta (400) BadArgument 'top' é inválido.
Solicitação incorreta (400) BadArgument Alvo do argumentoFace fora do intervalo.
Solicitação incorreta (400) BadArgument Argumento inválido targetFace. Causado por formato de cadeia de caracteres inválido ou valor inválido de esquerda/topo/altura/largura.
Solicitação incorreta (400) InvalidURL URL de imagem inválida. Os formatos compatíveis incluem JPEG, PNG, GIF (o primeiro quadro) e BMP.
Solicitação incorreta (400) InvalidURL URL de imagem inválida ou erro ao baixar do servidor de destino. Erro do servidor remoto retornado: "Ocorreu um erro ao enviar a solicitação".
Solicitação incorreta (400) InvalidImage Erro de decodificação. Formato da imagem não compatível.
Solicitação incorreta (400) InvalidImage Nenhum rosto detectado na imagem.
Solicitação incorreta (400) InvalidImage Há mais de 1 rosto na imagem.
Solicitação incorreta (400) InvalidImageSize O dimensionamento da imagem está muito pequeno. O tamanho do arquivo de imagem válido deve ser maior ou igual a 1 KB.
Solicitação incorreta (400) InvalidImageSize O dimensionamento da imagem está muito grande. O tamanho do arquivo de imagem válido não deve ser maior que 6 MB.
Não autorizado (401) 401 Acesso negado devido a chave de assinatura inválida ou ponto de extremidade de API incorreto. Certifique-se de fornecer uma chave válida para uma assinatura ativa e use um endpoint de API regional correto para seu recurso.
Proibido (403) UnsupportedFeature O recurso não é suportado, faltando aprovação para um ou mais dos seguintes recursos: Identificação, Verificação. Registre-se para acesso enviando um formulário de registro.
Conflito (409) Conflito de Operação Simultânea Há uma operação de conflito no recurso <resourceName>, tente mais tarde.
Muitos pedidos (429) 429 O limite da taxa é excedido.

Códigos de erro de detecção de rosto

Esses códigos de erro podem ser retornados pela operação de detecção de rosto.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument O argumento returnFaceAttributes é inválido.
Solicitação incorreta (400) BadArgument “returnFaceAttributes” não é compatível com detection_02.
Solicitação incorreta (400) BadArgument “returnLandmarks” não é compatível com detection_02.
Proibido (403) UnsupportedFeature Os atributos de retorno (emoção, sexo, idade, sorriso, pelos faciais, cabelo e maquiagem) foram descontinuados e não são mais suportados. Envie um e-mail para a equipe do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados.

Códigos de erro da Face Liveness Session

Esses códigos de erro podem ser retornados por operações de sessão de vivacidade facial.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument Start é inválido. Por favor, especifique o campo 'Id' da última entrada para continuar o processo de listagem.
Solicitação incorreta (400) BadArgument O parâmetro Top é inválido. O intervalo válido está entre 1 e 1000 inclusive.
Solicitação incorreta (400) InvalidRequestBody Corpo da solicitação incorreto fornecido. Verifique o esquema de operação e tente novamente.
Solicitação incorreta (400) InvalidTokenLifetime AuthTokenTimeToLiveInSeconds inválido especificado. Deve estar entre 60 e 86400.
Solicitação incorreta (400) InvalidLivenessOperationMode LivenessOperationMode inválido especificado. Deve ser 'Passivo'.
Solicitação incorreta (400) InvalidDeviceCorrelationId Uma ID de correlação de dispositivo é necessária no corpo da solicitação durante a criação ou o início da sessão. Não deve ser nulo ou vazio e não deve ter mais de 64 caracteres.
Não encontrado (404) SessionNotFound O ID da sessão não foi encontrado. O ID da sessão expirou ou não existe.

Códigos de erro de identificação facial

Esses códigos de erro podem ser retornados pela operação de identificação facial.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument 'recognitionModel' é incompatível.
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas é inválida.
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas grandes é inválida.
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas dinâmicas é inválida.
Solicitação incorreta (400) BadArgument O argumento maxNumOfCandidatesReturned não é válido. O intervalo válido está entre [1, 100].
Solicitação incorreta (400) BadArgument O argumento confidenceThreshold não é válido. O intervalo válido está entre [0, 1].
Solicitação incorreta (400) BadArgument O comprimento dos faceIds não está em um intervalo válido. O intervalo válido está entre [1, 10].
Solicitação incorreta (400) FaceNotFound O rosto não foi encontrado.
Solicitação incorreta (400) PersonGroupNotFound O grupo de pessoas não foi encontrado.
Solicitação incorreta (400) LargePersonGroupNotFound O grupo de pessoas grandes não é encontrado.
Solicitação incorreta (400) DynamicPersonGroupNotFound O grupo dinâmico de pessoas não foi encontrado.
Solicitação incorreta (400) PersonGroupNotTrained Grupo de pessoas não treinado.
Solicitação incorreta (400) LargePersonGroupNotTrained Grande grupo de pessoas não treinado.
Solicitação incorreta (400) PersonGroupIdAndLargePersonGroupIdBothNotNull A ID do grupo de pessoas grandes e a ID do grupo de pessoas não são nulas.
Solicitação incorreta (400) PersonGroupIdAndLargePersonGroupIdBothNull A ID do grupo de pessoas grandes e a ID do grupo de pessoas são nulas.
Solicitação incorreta (400) MissingIdentificationScopeParameters Nenhum parâmetro de escopo de identificação está presente na solicitação.
Solicitação incorreta (400) IncompatívelIdentificaçãoEscopoParâmetrosCombinação Parâmetros de escopo de identificação incompatíveis estão presentes na solicitação.
Conflito (409) PersonGroupTrainingNotFinished O grupo de pessoas está em treinamento.
Conflito (409) LargePersonGroupTrainingNotFinished Um grande grupo de pessoas está em treinamento.

Códigos de erro do Face Verify

Esses códigos de erro podem ser retornados pela operação Face Verify.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument 'recognitionModel' é incompatível.
Solicitação incorreta (400) BadArgument O Face ID é inválido. Um faceId válido vem de Face - Detect.
Solicitação incorreta (400) BadArgument A ID da pessoa é inválida. Um personId válido é gerado a partir de Criar Pessoa Grupo de Pessoas, Criar Pessoa de Grupo de Pessoas Grandes ou Diretório de Pessoas - Criar Pessoa.
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas é inválida.
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas grandes é inválida.
Solicitação incorreta (400) PessoaNãoEncontrada A pessoa não foi encontrada.
Solicitação incorreta (400) PersonGroupNotFound O grupo de pessoas não foi encontrado.
Solicitação incorreta (400) LargePersonGroupNotFound Grupo de pessoas grandes não foi encontrado.
Não encontrado (404) FaceNotFound O rosto não foi encontrado.
Não encontrado (404) PessoaNãoEncontrada A pessoa não foi encontrada.
Não encontrado (404) PersistedFaceNotFound Nenhum rosto persistente da pessoa é encontrado.

Encontrar códigos de erro semelhantes

Esses códigos de erro podem ser retornados pela operação Face Find Similar.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument 'recognitionModel' é incompatível.
Solicitação incorreta (400) BadArgument O modo é inválido.
Solicitação incorreta (400) BadArgument O ID da lista de rostos é inválido.
Solicitação incorreta (400) BadArgument O ID da lista de rostos grandes é inválido.
Solicitação incorreta (400) BadArgument LargeFaceListId, faceListId e faceIds, nenhum deles é exatamente válido.
Solicitação incorreta (400) BadArgument LargeFaceListId, faceListId e faceIds são todos nulos.
Solicitação incorreta (400) BadArgument 2 ou mais de largeFaceListId, faceListId e faceIds não são nulos.
Solicitação incorreta (400) BadArgument O argumento maxNumOfCandidatesReturned não é válido. O intervalo válido está entre [1, 1000].
Solicitação incorreta (400) BadArgument O comprimento dos faceIds não está em um intervalo válido. O intervalo válido está entre [1, 1000].
Solicitação incorreta (400) FaceNotFound O rosto não foi encontrado.
Solicitação incorreta (400) FaceListNotFound A lista de rostos não foi encontrada.
Solicitação incorreta (400) LargeFaceListNotFound A lista de rostos grande não foi encontrada.
Solicitação incorreta (400) LargeFaceListNotTrained A lista de rostos grande não é treinada.
Solicitação incorreta (400) FaceListNotReady A lista de rostos está vazia.
Conflito (409) LargeFaceListTrainingNotFinished Uma grande lista de rostos está em treinamento.

Códigos de erro do Grupo de Rostos

Esses códigos de erro podem ser retornados pela operação de grupo de rostos.

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument 'recognitionModel' é incompatível.
Solicitação incorreta (400) BadArgument O comprimento dos faceIds não está em um intervalo válido. O intervalo válido está entre [2, 1000].

Operações do grupo de pessoas

Esses códigos de erro podem ser retornados por operações de grupo de pessoas.

Códigos de erro do grupo de pessoas

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas é inválida. O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64.
Proibido (403) QuotaExceeded O número do grupo de pessoas atingiu o limite do nível de assinatura.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite de nível de grupo de pessoas.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite do nível de assinatura.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) PersonGroupNotFound O grupo de pessoas não foi encontrado.
Não encontrado (404) PersonGroupNotFound A ID do grupo de pessoas é inválida.
Não encontrado (404) PessoaNãoEncontrada A pessoa <personId> não foi encontrada.
Não encontrado (404) PessoaNãoEncontrada A ID da pessoa é inválida.
Não encontrado (404) PersistedFaceNotFound O rosto persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O rosto <faceId> persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O ID facial persistente é inválido.
Não encontrado (404) PersonGroupNotTrained Grupo de pessoas não treinado. Este erro aparece ao obter o status de treinamento de um grupo que nunca foi treinado.
Conflito (409) PersonGroupExists O grupo de pessoas já existe.
Conflito (409) PersonGroupTrainingNotFinished O grupo de pessoas está em treinamento. Tente novamente após a conclusão do treinamento.

Códigos de erro de grupo de pessoas grandes

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument A ID do grupo de pessoas grandes é inválida. O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64.
Solicitação incorreta (400) BadArgument Tanto 'name' quanto 'userData' estão vazios.
Proibido (403) QuotaExceeded O número de grupos de pessoas grandes atingiu o limite do nível de assinatura.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite de nível de grupo de pessoas grandes.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite do nível de assinatura.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) LargePersonGroupNotFound O grupo de pessoas grandes não é encontrado.
Não encontrado (404) LargePersonGroupNotFound A ID do grupo de pessoas grandes é inválida.
Não encontrado (404) PessoaNãoEncontrada A pessoa <personId> não foi encontrada.
Não encontrado (404) PessoaNãoEncontrada A ID da pessoa é inválida.
Não encontrado (404) PersistedFaceNotFound O rosto persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O rosto <faceId> persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O ID facial persistente é inválido.
Não encontrado (404) LargePersonGroupNotTrained Grande grupo de pessoas não treinado. Este erro aparece ao obter o status de treinamento de um grupo que nunca foi treinado.
Conflito (409) LargePersonGroupExists Já existe um grande grupo de pessoas.
Conflito (409) LargePersonGroupTrainingNotFinished Um grande grupo de pessoas está em treinamento. Tente novamente após a conclusão do treinamento.

Operações de lista de faces

Esses códigos de erro podem ser retornados por operações de Lista de Faces.

Códigos de erro da lista de rostos

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument O ID da lista de rostos é inválido. O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) FaceListNotFound A lista de rostos não foi encontrada.
Não encontrado (404) FaceListNotFound O ID da lista de rostos é inválido.
Não encontrado (404) PersistedFaceNotFound O rosto persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O ID facial persistente é inválido.
Conflito (409) FaceListExists A lista de rostos já existe.

Códigos de erro da lista de rostos grandes

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument O ID da lista de rostos grandes é inválido. O caractere válido é a letra inglesa em minúsculas, dígito, '-' ou '_'. O comprimento máximo é 64.
Solicitação incorreta (400) BadArgument Tanto 'name' quanto 'userData' estão vazios.
Proibido (403) QuotaExceeded O número de rostos grandes atingiu o limite.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) LargeFaceListNotFound A lista de rostos grande não foi encontrada.
Não encontrado (404) LargeFaceListNotFound O ID da lista de rostos grandes é inválido.
Não encontrado (404) PersistedFaceNotFound Lista de faces grandes A face <faceId> não foi encontrada.
Não encontrado (404) PersistedFaceNotFound O ID facial persistente é inválido.
Não encontrado (404) LargeFaceListNotTrained Lista de rostos grande não treinada. Este erro aparece ao obter o status de treinamento de uma lista de rostos grande que nunca foi treinada.
Conflito (409) LargeFaceListExists Já existe uma grande lista de rostos.
Conflito (409) LargeFaceListTrainingNotFinished Uma grande lista de rostos está em treinamento. Tente novamente após a conclusão do treinamento.

Operações do Diretório de Pessoas

Esses códigos de erro podem ser retornados por operações do Diretório de Pessoas.

Códigos de erro do Diretório de Pessoas

Código de status HTTP Código de erro Mensagem de erro Descrição
Solicitação incorreta (400) BadArgument O modelo de reconhecimento não é suportado para esse recurso.
Solicitação incorreta (400) BadArgument 'start' não é um ID de pessoa válido.
Solicitação incorreta (400) BadArgument Tanto 'name' quanto 'userData' estão vazios.
Solicitação incorreta (400) DynamicPersonGroupNotFound A ID do grupo de pessoas dinâmicas é inválida.
Proibido (403) QuotaExceeded O número de pessoas atingiu o limite do nível de assinatura.
Proibido (403) QuotaExceeded O número de rostos persistentes atingiu o limite.
Não encontrado (404) DynamicPersonGroupNotFound O grupo dinâmico de pessoas não foi encontrado.
Não encontrado (404) DynamicPersonGroupNotFound DynamicPersonGroupPersonReference <groupId> não foi encontrado.
Não encontrado (404) PessoaNãoEncontrada A pessoa não foi encontrada.
Não encontrado (404) PessoaNãoEncontrada A ID da pessoa é inválida.
Não encontrado (404) PersistedFaceNotFound O rosto persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O rosto <faceId> persistente não foi encontrado.
Não encontrado (404) PersistedFaceNotFound O Face ID persistente é inválido.
Conflito (409) DynamicPersonGroupExists A ID <groupId> dinâmica do grupo de pessoas já existe.

Próximas etapas