Person Group Operations - Create Large Person Group
Create un nuevo grupo de personas grandes con largePersonGroupId especificado por el usuario, el nombre, un userData y recognitionModel opcional.
Un grupo de personas grandes es un contenedor que contiene los datos de persona cargados, incluidas las características de reconocimiento facial. Puede contener hasta 1000 000 entidades.
Después de la creación, use "Create persona de grupo de personas grandes" para agregar persona al grupo y llame a "Train Large Person Group" (Entrenar grupo de personas grandes) para preparar este grupo para "Identificar desde un grupo de personas grandes".
No se almacenará ninguna imagen. Solo las características faciales extraídas de la persona y userData se almacenarán en el servidor hasta que se llame a "Eliminar persona de grupo de personas grandes" o "Eliminar grupo de personas grandes".
Se debe especificar 'recognitionModel' para asociarlo a este grupo de personas grandes. El valor predeterminado de "recognitionModel" es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita en este parámetro. Las nuevas caras que se agregan a un grupo de personas grandes existente usarán el modelo de reconocimiento que ya está asociado a la colección. Las características de caras existentes en un grupo de personas grandes no se pueden actualizar a las características extraídas por otra versión del modelo de reconocimiento.
Nota
-
- Cuota de suscripción de nivel gratuito: 1000 personas grandes Grupos.
- Cuota de suscripción de nivel S0: 1000 000 personas grandes Grupos.
PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
api
|
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://{nombre-recurso}.cognitiveservices.azure.com). |
large
|
path | True |
string |
Identificador del contenedor. Regex pattern: |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
name | True |
string |
Nombre definido por el usuario, la longitud máxima es 128. |
recognitionModel |
Recognition |
"recognitionModel" asociado a esta lista de caras. Los valores "recognitionModel" admitidos incluyen "recognition_01", "recognition_02, "recognition_03" y "recognition_04". El valor predeterminado es "recognition_01". Se recomienda "recognition_04", ya que su precisión se mejora en las caras que llevan máscaras en comparación con "recognition_03", y su precisión general se mejora en comparación con "recognition_01" y "recognition_02". |
|
userData |
string |
Datos opcionales definidos por el usuario. La longitud no debe superar los 16 0000. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
La solicitud se ha realizado correctamente. |
|
Other Status Codes |
Una 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
Create LargePersonGroup
Sample Request
PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id
{
"name": "your_large_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Sample Response
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 siguiente vínculo: 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 siguiente vínculo: 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. |