Compartir a través de


Person Group Operations - Train Large Person Group

Enviar una tarea de entrenamiento de grupo de personas grandes. El entrenamiento es un paso fundamental que solo un grupo de personas grandes entrenado puede usar "Identificar desde un grupo de personas grandes".
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 grandes. Podría estar en varios segundos, o hasta media hora para 1.000.000 personas. Para comprobar el estado de entrenamiento, use "Obtener estado de entrenamiento de grupo de personas grandes".

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/train

Parámetros de identificador URI

Nombre En Requerido Tipo Description
apiVersion
path True

string

Versión de API

endpoint
path True

string

uri

Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://{resource-name}.cognitiveservices.azure.com).

largePersonGroupId
path True

string

Identificador del contenedor.

Patrón de Regex: ^[a-z0-9-_]+$

Respuestas

Nombre Tipo Description
202 Accepted

Una llamada correcta devuelve un cuerpo de respuesta vacío.

Encabezados

operation-Location: string

Other Status Codes

FaceErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Clave secreta de la suscripción de Azure AI Face.

Tipo: apiKey
En: header

AADToken

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://api.example.com/oauth2/authorize
Dirección URL del token: https://api.example.com/oauth2/token

Ámbitos

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

Ejemplos

Train LargePersonGroup

Solicitud de ejemplo

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/train

Respuesta de muestra

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

Definiciones

Nombre Description
FaceError

Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el vínculo siguiente: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

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 vínculo siguiente: 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

FaceError

Objeto de error.