Face - Group

Servicio:

Azure AI Services

Versión de la API:

1.0

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 Face - Comprobar cuando solo tenga dos caras candidatas.
• Los faceIds "recognitionModel" asociados a las caras de consulta deben ser los mismos.

POST {Endpoint}/face/v1.0/group

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
faceIds	True	string[] (uuid)	Matriz de faceId candidata creada por Face - Detect. El máximo es de 1000 caras.

Respuestas

Nombre	Tipo	Description
200 OK	GroupResult	Una llamada correcta devuelve uno o varios grupos de caras similares (clasificación por tamaño de grupo) y un messyGroup.
Other Status Codes	APIError	Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Group example

Solicitud de ejemplo

HTTP

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

Definiciones

Nombre	Description
APIError	Información de error devuelta por la API
Error	Cuerpo del error.
GroupRequest	Cuerpo de la solicitud para la solicitud de grupo.
GroupResult	Matriz de grupos de caras en función de la similitud de caras.

APIError

Object

Información de error devuelta por la API

Nombre	Tipo	Description
error	Error	Cuerpo del error.

Error

Object

Cuerpo del error.

Nombre	Tipo	Description
code	string
message	string

GroupRequest

Object

Cuerpo de la solicitud para la solicitud de grupo.

Nombre	Tipo	Description
faceIds	string[] (uuid)	Matriz de faceId candidata creada por Face - Detect. El máximo es de 1000 caras.

GroupResult

Object

Matriz de grupos de caras en función de la similitud de caras.

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