Face Recognition Operations - Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Divide las caras de los candidatos en grupos en función de la similitud de la cara.

• • 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 la 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	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

Group Face IDs

Sample Request

HTTP

POST {endpoint}/face/v1.1-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"
  ]
}

Sample Response

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 siguiente vínculo: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Una respuesta que contiene los detalles del error.
GroupingResult	Cuerpo de respuesta para la operación de 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 siguiente vínculo: https://aka.ms/face-error-codes-and-messages.

Nombre	Tipo	Description
code	string	Uno de los conjuntos de códigos de error definidos por el servidor.
message	string	Representación legible del error.

FaceErrorResponse

Una respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	FaceError	Objeto de error.

GroupingResult

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

Nombre	Tipo	Description
groups	string[]	Partición de las caras originales en función de la similitud facial. Grupos se clasifican por número de caras.
messyGroup	string[]	Matriz de caras de caras que no pueden encontrar caras similares de caras originales.