Large Person Group - Create

Serviço:

Azure AI Services

Versão da API:

1.0-preview

Crie um novo grupo de pessoas grandes com largePersonGroupId especificado pelo usuário, nome, um userData e recognitionModel opcionais.
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 chamar LargePersonGroup – Treinar para preparar esse grupo para Face – Identificar.
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 neste parâmetro. Novos rostos adicionados 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 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-preview/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 maxLength: 64 pattern: ^[a-z0-9-_]+$	Id referenciando um grupo de pessoas grandes específico.

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 minLength: 1 maxLength: 128	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, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.
userData		string maxLength: 16384	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

Tipo: apiKey
Em: header

Exemplos

Create new large person group example

Solicitação de exemplo

HTTP

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


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

Resposta de exemplo

Código de status:

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, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

APIError

Objeto

Informações de erro retornadas pela API

Nome	Tipo	Description
error	Error	Corpo do erro.

Error

Objeto

Corpo do erro.

Nome	Tipo	Description
code	string
message	string

MetaDataContract

Objeto

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 minLength: 1 maxLength: 128		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, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.
userData	string maxLength: 16384		Dados especificados pelo usuário. O comprimento não deve exceder 16 KB.

RecognitionModel

Enumeração

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

Valor	Description
recognition_01
recognition_02
recognition_03
recognition_04