Person Group Operations - Create Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Create um novo Grupo de Pessoas Grandes com largePersonGroupId especificado pelo utilizador, nome, um userData opcional e recognitionModel.
Um Grupo de Pessoas Grandes é um contentor que contém os dados da pessoa carregada, incluindo as funcionalidades de reconhecimento facial. Pode conter até 1000 000 entidades.

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

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 de Grupo de Pessoas Grandes" ou "Eliminar Grupo de Pessoas Grandes".

"recognitionModel" deve ser especificado para associar a este Grupo de Pessoas Grandes. 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 Grandes existentes utilizarão o modelo de reconhecimento que já está associado à coleção. As funcionalidades faciais existentes num Grupo de Pessoas Grandes 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 grandes Grupos.
  • Quota de subscrição de escalão S0: 1000 000 Grupos pessoa grande.

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

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).
largePersonGroupId	path	True	string	ID do contentor. Regex pattern: ^[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. Headers x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Exemplos

Create LargePersonGroup

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id

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

Sample Response

Status code:

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.