Large Person Group - Create

Service:

Cognitive Services - Face

API Version:

1.0

Crie um grande grupo de pessoas com o largePersonGroupId especificado pelo usuário, o nome, um userData opcional e o recognitionModel.
Um grande grupo de pessoas é o contêiner dos dados da 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 chame LargePersonGroup – Treinar para preparar esse grupo para Detecção Facial – Identificar.
Nenhuma imagem será armazenada. Somente os recursos faciais 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 neste parâmetro. Novas faces adicionadas a um grupo de pessoas grandes existentes 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 gratuita: 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

Nome	Em	Obrigatório	Tipo	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 específico. Regex pattern: ^[a-z0-9-_]+$

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
name	True	string	Nome definido pelo usuário, o comprimento máximo é 128.
recognitionModel		RecognitionModel	Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos de rosto são extraídos e associados a faceIds detectadas, (Grande)FaceList ou (Grande)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect 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

Nome	Tipo	Description
200 OK		Uma chamada bem-sucedida retorna um corpo de resposta vazio.
Other Status Codes	APIError	Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemplos

Create new large person group example

Sample Request

HTTP

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

Status code:

200

Definições

Nome	Description
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 de rosto são extraídos e associados a faceIds detectadas, (Grande)FaceList ou (Grande)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect 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

Nome	Tipo	Description
error	Error	Corpo do erro.

Error

Corpo do erro.

Nome	Tipo	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.

Nome	Tipo	Valor padrão	Description
name	string		Nome definido pelo usuário, o comprimento máximo é 128.
recognitionModel	RecognitionModel	recognition_01	Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos de rosto são extraídos e associados a faceIds detectadas, (Grande)FaceList ou (Grande)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect 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 de rosto são extraídos e associados a faceIds detectadas, (Grande)FaceList ou (Grande)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect 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.

Nome	Tipo	Description
recognition_01	string
recognition_02	string
recognition_03	string
recognition_04	string