Large Person Group - Create

Crea un nuevo grupo de personas de gran tamaño con el elemento largePersonGroupId especificado por el usuario, el elemento name, un elemento opcional userData y el elemento recognitionModel.
Un grupo de personas grandes es el contenedor de los datos de personas cargados, incluida la característica de reconocimiento facial, y hasta 1000 000 personas.
Después de la creación, use LargePersonGroup Person - Create para agregar una persona al grupo y llame a LargePersonGroup - Train para preparar este grupo para Face - Identify.
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 LargePersonGroup Person - Delete o LargePersonGroup - Delete .
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 caras nuevas 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 faciales existentes de un grupo de personas grandes no se pueden actualizar a las características extraídas por otra versión del modelo de reconocimiento. Consulte Especificación de un modelo de reconocimiento facial.

Cuota de grupos de personas grandes:

  • Cuota de suscripción de nivel gratis: 1000 grupos de personas grandes.
  • Cuota de suscripción de nivel S0: 1000 000 grupos de personas grandes.
PUT {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}

Parámetros de identificador URI

Name In Required Type 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).

largePersonGroupId
path True
  • string

Identificador que hace referencia a un grupo de personas grandes determinado.

Regex pattern: ^[a-z0-9-_]+$

Encabezado de la solicitud

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Cuerpo de la solicitud

Name Required Type Description
name True
  • string

Nombre definido por el usuario, la longitud máxima es 128.

recognitionModel

Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando se extraen las características faciales y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

userData
  • string

Datos especificados por el usuario. La longitud no debe superar los 16 KB.

Respuestas

Name Type Description
200 OK

Una llamada correcta devuelve un cuerpo de respuesta vacío.

Other Status Codes

Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Ejemplos

Create new large person group example

Sample Request

PUT {Endpoint}/face/v1.0/largepersongroups/abc


{
  "name": "large-person-group-name",
  "userData": "User-provided data attached to the large person group.",
  "recognitionModel": "recognition_01"
}

Sample Response

Definiciones

APIError

Información de error devuelta por la API

Error

Cuerpo del error.

MetaDataContract

Combinación de nombre definido por el usuario y nombre de modelo de reconocimiento y datos especificados por el usuario para largePersonGroup/personGroup y largeFaceList/faceList.

RecognitionModel

Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando se extraen las características faciales y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

APIError

Información de error devuelta por la API

Name Type Description
error

Cuerpo del error.

Error

Cuerpo del error.

Name Type Description
code
  • string
message
  • string

MetaDataContract

Combinación de nombre definido por el usuario y nombre de modelo de reconocimiento y datos especificados por el usuario para largePersonGroup/personGroup y largeFaceList/faceList.

Name Type Default Value Description
name
  • string

Nombre definido por el usuario, la longitud máxima es 128.

recognitionModel recognition_01

Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando se extraen las características faciales y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

userData
  • string

Datos especificados por el usuario. La longitud no debe superar los 16 KB.

RecognitionModel

Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando se extraen las características faciales y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

Name Type Description
recognition_01
  • string
recognition_02
  • string
recognition_03
  • string
recognition_04
  • string