Large Person Group - Create

Crie um grande grupo de pessoas com o largePersonGroupId especificado pelo usuário, o nome, um userData opcional e o recognitionModel.
Um grupo de pessoas grandes é o contêiner dos dados de pessoa carregada, incluindo o recurso de reconhecimento facial e até 1.000.000 pessoas.
Após a criação, use LargePersonGroup Person – Criar para adicionar pessoa ao grupo e chamar LargePersonGroup – Treine para preparar esse grupo para o Face – Identifique.
Nenhuma imagem será armazenada. Somente os recursos de rosto extraídos da pessoa e userData serão armazenados no servidor até que LargePersonGroup Person - Delete ou LargePersonGroup - Delete seja chamado.
'recognitionModel' deve ser especificado para associar a esse grupo de pessoas grandes. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário nesse parâmetro. Novas faces adicionadas a um grupo de pessoas grandes existente usarão o modelo de reconhecimento que já está associado à coleção. Os recursos de rosto existentes em um grupo de pessoas grandes não podem ser atualizados para recursos extraídos por outra versão do modelo de reconhecimento. Consulte Especificar um modelo de reconhecimento facial.

Cota de grupo de pessoas grandes:

  • Cota de assinatura de camada livre: 1.000 grupos de pessoas grandes.
  • Cota de assinatura de nível S0: 1.000.000 grupos de pessoas grandes.
PUT {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}

Parâmetros de URI

Name In Required Type Description
Endpoint
path True
  • string

Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

Id referenciando um grupo de pessoas grandes em particular.

Regex pattern: ^[a-z0-9-_]+$

Cabeçalho da solicitação

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Corpo da solicitação

Name Required Type Description
name True
  • string

Nome definido pelo usuário, o comprimento máximo é 128.

recognitionModel

Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos faciais são extraídos e associados a faceIds detectadas, (Grande)FaceList ou PersonGroup (Grande). Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detectar ou (Grande)FaceList - Criar ou (Grande)PersonGroup - Criar. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

userData
  • string

Dados especificados pelo usuário. O comprimento não deve exceder 16 KB.

Respostas

Name Type Description
200 OK

Uma chamada bem-sucedida retorna um corpo de resposta vazio.

Other Status Codes

Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemplos

Create new large person group example

Sample Request

PUT {Endpoint}/face/v1.0/largepersongroups/abc


{
  "name": "large-person-group-name",
  "userData": "User-provided data attached to the large person group.",
  "recognitionModel": "recognition_01"
}

Sample Response

Definições

APIError

Informações de erro retornadas pela API

Error

Corpo do erro.

MetaDataContract

Uma combinação de nome definido pelo usuário e nome de modelo de reconhecimento e dados especificados pelo usuário para largePersonGroup/personGroup e largeFaceList/faceList.

RecognitionModel

Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos faciais são extraídos e associados a faceIds detectadas, (Grande)FaceList ou PersonGroup (Grande). Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detectar ou (Grande)FaceList - Criar ou (Grande)PersonGroup - Criar. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

APIError

Informações de erro retornadas pela API

Name Type Description
error

Corpo do erro.

Error

Corpo do erro.

Name Type Description
code
  • string
message
  • string

MetaDataContract

Uma combinação de nome definido pelo usuário e nome de modelo de reconhecimento e dados especificados pelo usuário para largePersonGroup/personGroup e largeFaceList/faceList.

Name Type Default Value Description
name
  • string

Nome definido pelo usuário, o comprimento máximo é 128.

recognitionModel recognition_01

Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos faciais são extraídos e associados a faceIds detectadas, (Grande)FaceList ou PersonGroup (Grande). Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detectar ou (Grande)FaceList - Criar ou (Grande)PersonGroup - Criar. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

userData
  • string

Dados especificados pelo usuário. O comprimento não deve exceder 16 KB.

RecognitionModel

Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos faciais são extraídos e associados a faceIds detectadas, (Grande)FaceList ou PersonGroup (Grande). Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detectar ou (Grande)FaceList - Criar ou (Grande)PersonGroup - Criar. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

Name Type Description
recognition_01
  • string
recognition_02
  • string
recognition_03
  • string
recognition_04
  • string