Face Recognition Operations - Group

Servicio:

Azure AI Services

Versión de la API:

v1.2-preview.1

Divida las caras candidatas en grupos en función de la similitud de caras.

• • La salida es uno o varios grupos de caras separados y un messyGroup. Un grupo de caras contiene caras que tienen un aspecto similar, a menudo de la misma persona. Los grupos de caras se clasifican por tamaño de grupo, es decir, el número de caras. Observe que las caras que pertenecen a una misma persona pueden dividirse en varios grupos en el resultado.
  • MessyGroup es un grupo de caras especial que contiene caras que no pueden encontrar ninguna cara equivalente similar de caras originales. El messyGroup no aparecerá en el resultado si todas las caras encontraron sus homólogos.
  • La API de grupo necesita al menos 2 caras candidatas y 1000 como máximo. Se recomienda probar "Comprobar cara a cara" cuando solo tiene 2 caras candidatas.
  • Los faceIds "recognitionModel" asociados a las caras de consulta deben ser los mismos.

POST {endpoint}/face/{apiVersion}/group

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).

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
faceIds	True	string[]	Matriz de faceIds candidatas creadas por "Detect". El máximo es de 1000 caras.

Respuestas

Nombre	Tipo	Description
200 OK	GroupingResult	Una llamada correcta devuelve uno o varios grupos de caras similares (clasificación por tamaño de grupo) y un messyGroup.
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

Group Face IDs

Solicitud de ejemplo

HTTP

POST {endpoint}/face/v1.2-preview.1/group

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "65d083d4-9447-47d1-af30-b626144bf0fb",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "30ea1073-cc9e-4652-b1e3-d08fb7b95315",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ]
}

Respuesta de muestra

status code:

200

{
  "groups": [
    [
      "c5c24a82-6845-4031-9d5d-978df9175426",
      "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
      "fce92aed-d578-4d2e-8114-068f8af4492e",
      "b64d5e15-8257-4af2-b20a-5a750f8940e7"
    ],
    [
      "65d083d4-9447-47d1-af30-b626144bf0fb",
      "30ea1073-cc9e-4652-b1e3-d08fb7b95315"
    ]
  ],
  "messyGroup": [
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
  ]
}

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.
GroupingResult	Cuerpo de respuesta para la operación de la cara de grupo.

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.

GroupingResult

Cuerpo de respuesta para la operación de la cara de grupo.

Nombre	Tipo	Description
groups	string[]	Partición de las caras originales basadas en la similitud de caras. Los grupos se clasifican por número de caras.
messyGroup	string[]	Matriz de face ids de caras que no pueden encontrar caras similares de caras originales.