---
title: "POST /api/v1/selphid/identify/enroll/{galleryId}/{templateId}"
method: POST
path: "/api/v1/selphid/identify/enroll/{galleryId}/{templateId}"
tags: ["Gallery 1:n"]
---

# POST /api/v1/selphid/identify/enroll/{galleryId}/{templateId}

`POST /api/v1/selphid/identify/enroll/{galleryId}/{templateId}`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/facephi/apis/selphid-sdk-rest-api/docs/api/v1/selphid/identify/enroll/:galleryId/:templateId/post.ts> (a function with typed inputs; its response is checked against the schema)

Inscribe en una galería una plantilla facial obtenida a partir de una imagen.

## Path parameters

- `galleryId` string, required: El nombre de una galería de plantillas faciales.
- `templateId` string, required: El nombre de una plantilla facial en una galería.

## Request body

- GalleryImage: Una imagen en bruto, utilizada para la inscripción en una galería 1:N.
  - `image` string, required: Buffer de imagen en formato JPEG, PNG o BMP, codificado en base64 RFC4648.
  - `options` SdkOptions: Opciones para personalizar el uso de los motores de extracción e identificación. Su uso es opcional y ninguna opción es obligatoria. Si se omiten, se usarán los valores por defecto.
    - `longDetail` boolean: Si es true, el resultado del endpoint incluirá información adicional. Si se omite, el valor por defecto será false.
    - `elapsedAllowedSeconds` integer: Tiempo de vida máximo de un templateRaw (en segundos) para considerarse válido en operaciones de autenticación o prueba de vida. Si es 0 (por defecto), no hay límite.
    - `futureAllowedSeconds` integer: Tiempo de vida futuro máximo de un templateRaw (en segundos) para considerarse válido en operaciones de autenticación o prueba de vida. La plantilla puede haberse creado en un dispositivo con una fecha futura respecto al dispositivo que la consume. Si es 0 (por defecto), no se aceptará ningún templateRaw con una fecha futura.
    - `facialDetection` 'Frontal' | 'FrontalFast': Tipos de detección facial en el motor de extracción.
    - `minFaceAbsPx` integer: Tamaño mínimo en píxeles que debe tener un rostro para ser detectado.
    - `minFaceRel` number: Tamaño mínimo, en proporción al tamaño de la imagen, que debe tener un rostro para ser detectado.
    - `minIodPx` integer: Distancia interocular mínima en píxeles que debe tener un rostro para ser detectado.
    - `maxPoseDegrees` number: Diferencia máxima de ángulo (en grados) entre dos poses para considerarse válida en procesos de autenticación.
    - `minFacialQuality` 'None' | 'Bad' | 'Regular' | 'Good': Una métrica que indica con qué precisión se comportará una plantilla en el reconocimiento.
    - `analyticsDetection` boolean: Obtiene analíticas adicionales en el motor de extracción.
    - `templateRawExtraction` boolean: El motor de extracción generará la plantilla en bruto.
    - `falseDetectRate` number: Nivel de tolerancia de falso rechazo en el motor de extracción. No se recomienda usar este valor si no está seguro de sus efectos.
    - `maxCantidates` integer: El número máximo de candidatos que se desean en la respuesta.
    - `minSimilarity` number: La similitud mínima requerida para que un candidato se incluya en la respuesta.
    - `authThreshold` number: Valor mínimo en una autenticación para considerarla positiva.
    - `livenessDepth` 'None' | 'Partial' | 'Full': Qué pipelines de prueba de vida deben utilizarse.

## Response `200`

Resultado de la inscripción.

- EnrollResult: El resultado de la inscripción de una plantilla en una galería.
  - `galleryIndex` integer: La posición que ocupa un elemento en la galería.
  - `facialTemplate` string: Patrón biométrico facial, codificado en base64 RFC4648.
  - `sdkDuration` number: Duración de la operación en milisegundos.

## Other responses

- `400`: Parámetros incorrectos en la solicitud.
- `500`: Se ha producido un error en la llamada al backend de SelphID-SDK.

---

[API](https://skmtc.dev/facephi/apis/selphid-sdk-rest-api.md) - [All operations](https://skmtc.dev/facephi/apis/selphid-sdk-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/facephi/apis/selphid-sdk-rest-api/revisions/acc985032f98?raw)