Partilhar via


Person Group Operations - Train Person Group

Envie uma tarefa de treinamento do Grupo de Pessoas. O treinamento é uma etapa crucial que apenas um Grupo de Pessoas treinado pode ser usado pelo "Grupo de Identificação de Pessoas".
A tarefa de treinamento é uma tarefa assíncrona. O tempo de treinamento depende do número de pessoas inscritas e de seus rostos em um Grupo de Pessoas. Pode ser de vários segundos a minutos. Para verificar o status do treinamento, use "Obter status de treinamento em grupo de pessoas".

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/train

Parâmetros do URI

Name Em Necessário Tipo Description
apiVersion
path True

string

Versão da API

endpoint
path True

string

uri

Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://{resource-name}.cognitiveservices.azure.com).

personGroupId
path True

string

ID do contentor.

Padrão Regex: ^[a-z0-9-_]+$

Respostas

Name Tipo Description
202 Accepted

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

Cabeçalhos

operation-Location: string

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 para sua assinatura do Azure AI Face.

Tipo: apiKey
Em: header

AADToken

O fluxo OAuth2 do Azure Ative 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

Train PersonGroup

Pedido de amostra

POST {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/train

Resposta da amostra

operation-Location: https://contoso.com/operationstatus

Definições

Name Description
FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Face Service, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Uma resposta contendo detalhes do erro.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Face Service, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

Name Tipo Description
code

string

Um de um conjunto de códigos de erro definido pelo servidor.

message

string

Uma representação legível por humanos do erro.

FaceErrorResponse

Uma resposta contendo detalhes do erro.

Name Tipo Description
error

FaceError

O objeto de erro.