Person Group Operations - Train Person Group
Enviar una tarea de entrenamiento de grupo de personas. El entrenamiento es un paso fundamental que solo puede usar un grupo de personas entrenado por "Identificar desde grupo de personas".
La tarea de entrenamiento es una tarea asincrónica. El tiempo de entrenamiento depende del número de entradas de persona y de sus caras en un grupo de personas. Podría ser de varios segundos a minutos. Para comprobar el estado de entrenamiento, use "Obtener estado de entrenamiento de grupo de personas".
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/train
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
api
|
path | True |
string |
Versión de la API |
endpoint
|
path | True |
string uri |
Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://{nombre-recurso}.cognitiveservices.azure.com). |
person
|
path | True |
string |
Identificador del contenedor. Regex pattern: |
Respuestas
Nombre | Tipo | Description |
---|---|---|
202 Accepted |
Una llamada correcta devuelve un cuerpo de respuesta vacío. Headers operation-Location: string |
|
Other Status Codes |
Una respuesta de error inesperada. Headers x-ms-error-code: string |
Seguridad
Ocp-Apim-Subscription-Key
Clave secreta de la suscripción de Azure AI Face.
Type:
apiKey
In:
header
AADToken
Flujo de OAuth2 de Azure Active Directory
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Nombre | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Ejemplos
Train PersonGroup
Sample Request
POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/train
Sample Response
operation-Location: https://contoso.com/operationstatus
Definiciones
Nombre | Description |
---|---|
Face |
Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el siguiente vínculo: https://aka.ms/face-error-codes-and-messages. |
Face |
Respuesta que contiene los detalles del error. |
FaceError
Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el siguiente vínculo: https://aka.ms/face-error-codes-and-messages.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Uno de un conjunto definido por el servidor de códigos de error. |
message |
string |
Representación legible del error. |
FaceErrorResponse
Respuesta que contiene los detalles del error.
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |