--- title: "POST /api/v1/selphid/extract/template" method: POST path: "/api/v1/selphid/extract/template" tags: ["Extract"] --- # POST /api/v1/selphid/extract/template `POST /api/v1/selphid/extract/template` Extrae la plantilla facial y las características a partir de una plantilla en bruto. ## Request body - ExtractTemplate — Una plantilla en bruto, utilizada para la extracción. - `faceTemplate` string, required — Patrón biométrico facial, 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 extracción facial. - FacialExtractionResult — El resultado de una operación de extracción. - `facialTemplate` string — Patrón biométrico facial, codificado en base64 RFC4648. - `facialTemplateRaw` string — Un token extendido que contiene patrones biométricos y metadatos. Se recomienda su almacenamiento en bases de datos por ser persistente. Puede actualizarse automáticamente en caso de cambios en la tecnología de extracción. Está codificado en base64 RFC4648. - `updatedTemplateRaw` boolean — Si es true, significa que el templateRaw se ha actualizado tras una operación de extracción. Esto se puede usar para determinar si el templateRaw debe actualizarse en las bases de datos. - `face` Rectangle — Un área delimitada de una imagen. - `x` number — Coordenada X de la esquina superior izquierda. - `y` number — Coordenada Y de la esquina superior izquierda. - `width` number — Anchura del área. - `height` number — Altura del área. - `leftEye` object — Ubicación del centro del ojo izquierdo. - `x` number — Coordenada X. - `y` number — Coordenada Y. - `rightEye` object — Ubicación del centro del ojo derecho. - `x` number — Coordenada X. - `y` number — Coordenada Y. - `chin` object — Ubicación de la barbilla. - `x` number — Coordenada X. - `y` number — Coordenada Y. - `nose` object — Ubicación de la nariz. - `x` number — Coordenada X. - `y` number — Coordenada Y. - `leftMouth` object — Ubicación del punto izquierdo de la boca. - `x` number — Coordenada X. - `y` number — Coordenada Y. - `rightMouth` object — Ubicación del punto derecho de la boca. - `x` number — Coordenada X. - `y` number — Coordenada Y. - `iod` number — Distancia interocular. - `yaw` number — Ángulo facial de guiñada (yaw) en grados. - `pitch` number — Ángulo facial de cabeceo (pitch) en grados. - `roll` number — Ángulo facial de alabeo (roll) en grados. - `glasses` 'None' | 'Eye' | 'Sun' — La persona de la imagen lleva gafas (y de qué tipo). - `age` number — Aproximación de la edad de la persona. - `gender` 'None' | 'Male' | 'Female' — El género facial de la persona en la imagen. - `mask` number — La probabilidad de mascarilla facial. - `faceConfidence` number — Confianza predicha del rostro. - `facialQuality` 'None' | 'Bad' | 'Regular' | 'Good' — Una métrica que indica con qué precisión se comportará una plantilla en el reconocimiento. - `validTimeStamp` boolean — En las operaciones de autenticación, prueba de vida y extracción que implican templateRaws, indica si el tiempo de vida de la plantilla es válido. Véase "options:elapsedAllowedSeconds". En las operaciones que no implican plantillas en bruto, siempre será true. - `tokenTimeStamp` string — El valor interno de fecha y hora del token en formato "%Y-%m-%dT%H:%M:%SZ". - `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.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)