Person Group Operations - Create Person Group

Serviço:

Azure AI Services

Versão da API:

v1.1-preview.1

Create um novo Grupo de Pessoas com personGroupId especificado, nome, userData fornecido pelo utilizador e recognitionModel.
Um Grupo de Pessoas é um contentor que contém os dados da pessoa carregada, incluindo as funcionalidades de reconhecimento facial.

Após a criação, utilize "Create Pessoa do Grupo de Pessoas" para adicionar pessoas ao grupo e, em seguida, chame "Preparar Grupo de Pessoas" para preparar este grupo para "Identificar a Partir do Grupo pessoa".

Nenhuma imagem será armazenada. Apenas as funcionalidades faciais extraídas da pessoa e userData serão armazenadas no servidor até que seja chamado "Eliminar Pessoa do Grupo de Pessoas" ou "Eliminar Grupo de Pessoas".

"recognitionModel" deve ser especificado para associar a este Grupo de Pessoas. O valor predefinido para "recognitionModel" é "recognition_01", se for necessário o modelo mais recente, especifique explicitamente o modelo de que precisa neste parâmetro. Os novos rostos adicionados a um Grupo de Pessoas existentes utilizarão o modelo de reconhecimento que já está associado à coleção. As funcionalidades faciais existentes num Grupo de Pessoas não podem ser atualizadas para funcionalidades extraídas por outra versão do modelo de reconhecimento.

Nota

• • Quota de subscrição de escalão gratuito: 1000 pessoas Grupos. Cada uma tem até 1.000 pessoas.
  • Quota de subscrição de escalão S0: 1000 000 pessoas Grupos. Cada uma tem até 10.000 pessoas.
  • para lidar com um problema de identificação facial de maior escala, considere utilizar o Grupo de Pessoas Grandes.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
apiVersion	path	True	string	Versão da API
endpoint	path	True	string uri	Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://{resource-name}.cognitiveservices.azure.com).
personGroupId	path	True	string	ID do contentor. Padrão Regex: ^[a-z0-9-_]+$

Corpo do Pedido

Name	Necessário	Tipo	Description
name	True	string	Nome definido pelo utilizador, o comprimento máximo é 128.
recognitionModel		RecognitionModel	O "recognitionModel" associado a esta lista de rostos. Os valores "recognitionModel" suportados incluem "recognition_01", "recognition_02, "recognition_03" e "recognition_04". O valor predefinido é "recognition_01". Recomenda-se "recognition_04", uma vez que a sua precisão é melhorada nos rostos que usam máscaras em comparação com "recognition_03", e a sua precisão geral é melhorada em comparação com "recognition_01" e "recognition_02".
userData		string	Dados definidos pelo utilizador opcionais. O comprimento não deve exceder os 16 K.

Respostas

Name	Tipo	Description
200 OK		O pedido foi bem-sucedido.
Other Status Codes	FaceErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

A chave secreta da sua subscrição do Azure AI Face.

Tipo: apiKey
Em: header

AADToken

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: accessCode
URL de Autorização: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Âmbitos

Name	Description
https://cognitiveservices.azure.com/.default

Exemplos

Create PersonGroup

Pedido de amostra

HTTP

PUT {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id

{
  "name": "your_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Resposta da amostra

Código de estado:

200

Definições

Name	Description
FaceError	O objeto de erro. Para obter detalhes abrangentes sobre os códigos de erro e as mensagens devolvidas pelo Serviço Face, consulte a seguinte ligação: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Uma resposta que contém detalhes de erro.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre os códigos de erro e as mensagens devolvidas pelo Serviço Face, consulte a seguinte ligação: https://aka.ms/face-error-codes-and-messages.

Name	Tipo	Description
code	string	Um dos conjuntos de códigos de erro definidos pelo servidor.
message	string	Uma representação legível por humanos do erro.

FaceErrorResponse

Uma resposta que contém detalhes de erro.

Name	Tipo	Description
error	FaceError	O objeto de erro.