Face List Operations - Train Large Face List
Enviar una tarea de entrenamiento de lista de caras grandes.
El entrenamiento es un paso fundamental que solo puede usar una lista de caras grandes entrenada por "Buscar similar de la lista de caras grandes".
La tarea de entrenamiento es una tarea asincrónica. El tiempo de entrenamiento depende del número de entradas faciales de una lista de caras grandes. Podría estar en segundos o hasta media hora para 1000 000 caras. Para comprobar la finalización del entrenamiento, use "Obtener estado de entrenamiento de la lista de caras grandes".
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/train
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
api
|
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). |
large
|
path | True |
string |
El carácter válido es letra en minúsculas o dígitos o "-" o "_", la longitud máxima es 64. Patrón de Regex: |
Respuestas
Nombre | Tipo | Description |
---|---|---|
202 Accepted |
Una llamada correcta devuelve un cuerpo de respuesta vacío. Encabezados operation-Location: string |
|
Other Status Codes |
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 LargeFaceList
Solicitud de ejemplo
POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/train
Respuesta de muestra
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 vínculo siguiente: 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 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 |
Objeto de error. |