> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/selphid/technical_documentation/api_reference/authentication/api-v1-selphid-authenticate-facial-images.md).

# /api/v1/selphid/authenticate-facial/images

Autentica dos plantillas faciales, obtenidas a partir de dos búferes de imagen.

```json
{"openapi":"3.0.0","info":{"title":"SelphID-SDK Rest API","version":"6.21.0"},"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Nombre de la cabecera de la clave de API por defecto. Puede sobrescribirse en el arranque con `auth_api_key_header_name`."}},"schemas":{"FacialAuthenticationImages":{"type":"object","description":"Dos imágenes en bruto, utilizadas para la autenticación.","properties":{"image1":{"$ref":"#/components/schemas/ImageBuffer"},"image2":{"$ref":"#/components/schemas/ImageBuffer"},"options":{"$ref":"#/components/schemas/SdkOptions"}},"required":["image1","image2"]},"ImageBuffer":{"type":"string","description":"Búfer en bruto de imagen en .png, .jpg o .bmp, codificado en base64."},"SdkOptions":{"type":"object","description":"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.","properties":{"longDetail":{"$ref":"#/components/schemas/LongDetail"},"elapsedAllowedSeconds":{"$ref":"#/components/schemas/ElapsedSeconds"},"futureAllowedSeconds":{"$ref":"#/components/schemas/FutureSeconds"},"facialDetection":{"$ref":"#/components/schemas/FacialDetectionType"},"minFaceAbsPx":{"$ref":"#/components/schemas/MinFaceSize"},"minFaceRel":{"$ref":"#/components/schemas/MinFaceRel"},"minIodPx":{"$ref":"#/components/schemas/MinIOD"},"maxPoseDegrees":{"$ref":"#/components/schemas/MaxPoseDegrees"},"minFacialQuality":{"$ref":"#/components/schemas/FacialQuality"},"analyticsDetection":{"$ref":"#/components/schemas/Analytics"},"templateRawExtraction":{"$ref":"#/components/schemas/TemplateRawExtraction"},"falseDetectRate":{"$ref":"#/components/schemas/FalseDetectRate"},"maxCantidates":{"$ref":"#/components/schemas/MaxCandidates"},"minSimilarity":{"$ref":"#/components/schemas/MinSimilarity"},"authThreshold":{"$ref":"#/components/schemas/AuthThreshold"},"livenessDepth":{"$ref":"#/components/schemas/LivenessDepth"}}},"LongDetail":{"type":"boolean","description":"Si es true, el resultado del endpoint incluirá información adicional. Si se omite, el valor por defecto será false."},"ElapsedSeconds":{"type":"integer","description":"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.","minimum":0},"FutureSeconds":{"type":"integer","description":"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.","minimum":0},"FacialDetectionType":{"type":"string","description":"Tipos de detección facial en el motor de extracción.","enum":["Frontal","FrontalFast"]},"MinFaceSize":{"type":"integer","description":"Tamaño mínimo en píxeles que debe tener un rostro para ser detectado."},"MinFaceRel":{"type":"number","description":"Tamaño mínimo, en proporción al tamaño de la imagen, que debe tener un rostro para ser detectado.","minimum":0,"maximum":1},"MinIOD":{"type":"integer","description":"Distancia interocular mínima en píxeles que debe tener un rostro para ser detectado."},"MaxPoseDegrees":{"type":"number","description":"Diferencia máxima de ángulo (en grados) entre dos poses para considerarse válida en procesos de autenticación.","minimum":0,"maximum":180},"FacialQuality":{"type":"string","description":"Una métrica que indica con qué precisión se comportará una plantilla en el reconocimiento.","enum":["None","Bad","Regular","Good"]},"Analytics":{"type":"boolean","description":"Obtiene analíticas adicionales en el motor de extracción."},"TemplateRawExtraction":{"type":"boolean","description":"El motor de extracción generará la plantilla en bruto."},"FalseDetectRate":{"type":"number","description":"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.","minimum":0,"maximum":1},"MaxCandidates":{"type":"integer","description":"Número máximo de candidatos requeridos en búsquedas 1:N."},"MinSimilarity":{"type":"number","description":"Similitud mínima tolerable en búsquedas 1:N.","minimum":0,"maximum":1},"AuthThreshold":{"type":"number","description":"Valor mínimo en una autenticación para considerarla positiva.","minimum":0,"maximum":100},"LivenessDepth":{"type":"string","description":"Qué pipelines de prueba de vida deben utilizarse.","enum":["None","Partial","Full"]},"FacialAuthenticationResult":{"type":"object","description":"El resultado de una operación de autenticación. **extractionQuery** y **extractionTarget** solo se añadirán si **options:longDetail=true**.","properties":{"authStatus":{"$ref":"#/components/schemas/FacialAuthenticationStatus"},"similarity":{"$ref":"#/components/schemas/Similarity"},"validTimeStamp":{"$ref":"#/components/schemas/ValidTimeStamp"},"tokenTimeStamp":{"$ref":"#/components/schemas/TokenTimeStamp"},"trackingStatus":{"$ref":"#/components/schemas/TrackingStatus"},"trackingMessage":{"$ref":"#/components/schemas/TrackingMessage"},"sdkDuration":{"$ref":"#/components/schemas/SdkDuration"},"extractionQuery":{"$ref":"#/components/schemas/FacialExtractionResult"},"extractionTarget":{"$ref":"#/components/schemas/FacialExtractionResult"}}},"FacialAuthenticationStatus":{"type":"string","description":"Posibles resultados de una operación de autenticación.","enum":["None","Negative","Uncertain","Positive","NoneBecausePoseExceed","NoneBecauseInvalidExtractions"]},"Similarity":{"type":"number","description":"Similitud entre dos plantillas faciales (0-Ninguna, 1-Idéntica)."},"ValidTimeStamp":{"type":"boolean","description":"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":{"type":"string","description":"El valor interno de fecha y hora del token en formato \"%Y-%m-%dT%H:%M:%SZ\"."},"TrackingStatus":{"type":"number","description":"Estado devuelto por el servicio Api Tracking, o -1 si no se requiere seguimiento."},"TrackingMessage":{"type":"string","description":"Mensaje devuelto por el servicio Api Tracking, o vacío si no se requiere seguimiento."},"SdkDuration":{"type":"number","description":"Duración de la operación en milisegundos."},"FacialExtractionResult":{"type":"object","description":"El resultado de una operación de extracción.","properties":{"facialTemplate":{"$ref":"#/components/schemas/FacialTemplate"},"facialTemplateRaw":{"$ref":"#/components/schemas/FacialTemplateRaw"},"updatedTemplateRaw":{"$ref":"#/components/schemas/UpdatedTemplateRaw"},"face":{"$ref":"#/components/schemas/Rectangle"},"leftEye":{"description":"Ubicación del centro del ojo izquierdo.","type":"object","properties":{"x":{"$ref":"#/components/schemas/XCoord"},"y":{"$ref":"#/components/schemas/YCoord"}}},"rightEye":{"description":"Ubicación del centro del ojo derecho.","type":"object","properties":{"x":{"$ref":"#/components/schemas/XCoord"},"y":{"$ref":"#/components/schemas/YCoord"}}},"chin":{"description":"Ubicación de la barbilla.","type":"object","properties":{"x":{"$ref":"#/components/schemas/XCoord"},"y":{"$ref":"#/components/schemas/YCoord"}}},"nose":{"description":"Ubicación de la nariz.","type":"object","properties":{"x":{"$ref":"#/components/schemas/XCoord"},"y":{"$ref":"#/components/schemas/YCoord"}}},"leftMouth":{"description":"Ubicación del punto izquierdo de la boca.","type":"object","properties":{"x":{"$ref":"#/components/schemas/XCoord"},"y":{"$ref":"#/components/schemas/YCoord"}}},"rightMouth":{"description":"Ubicación del punto derecho de la boca.","type":"object","properties":{"x":{"$ref":"#/components/schemas/XCoord"},"y":{"$ref":"#/components/schemas/YCoord"}}},"iod":{"$ref":"#/components/schemas/IOD"},"yaw":{"description":"Ángulo facial de guiñada (yaw) en grados.","type":"number"},"pitch":{"description":"Ángulo facial de cabeceo (pitch) en grados.","type":"number"},"roll":{"description":"Ángulo facial de alabeo (roll) en grados.","type":"number"},"glasses":{"$ref":"#/components/schemas/FacialGlasses"},"age":{"$ref":"#/components/schemas/Age"},"gender":{"$ref":"#/components/schemas/FacialGender"},"mask":{"$ref":"#/components/schemas/FacialMask"},"faceConfidence":{"$ref":"#/components/schemas/FaceConfidence"},"facialQuality":{"$ref":"#/components/schemas/FacialQuality"},"validTimeStamp":{"$ref":"#/components/schemas/ValidTimeStamp"},"tokenTimeStamp":{"$ref":"#/components/schemas/TokenTimeStamp"},"sdkDuration":{"$ref":"#/components/schemas/SdkDuration"}}},"FacialTemplate":{"type":"string","description":"Búfer de plantilla biométrica, obtenido mediante GetFacialTemplate(), codificado en base64."},"FacialTemplateRaw":{"type":"string","description":"Búfer de plantilla biométrica, obtenido mediante GetFacialTemplateRaw(), codificado en base64."},"UpdatedTemplateRaw":{"type":"boolean","description":"El templateRaw se ha actualizado en la operación de extracción."},"Rectangle":{"type":"object","description":"Un área delimitada de una imagen.","properties":{"x":{"type":"number","description":"Coordenada X de la esquina superior izquierda."},"y":{"type":"number","description":"Coordenada Y de la esquina superior izquierda."},"width":{"type":"number","description":"Anchura del área."},"height":{"type":"number","description":"Altura del área."}}},"XCoord":{"type":"number","description":"Coordenada X."},"YCoord":{"type":"number","description":"Coordenada Y."},"IOD":{"type":"number","description":"Distancia interocular."},"FacialGlasses":{"type":"string","description":"La persona de la imagen lleva gafas (y de qué tipo).","enum":["None","Eye","Sun"]},"Age":{"type":"number","description":"Aproximación de la edad de la persona."},"FacialGender":{"type":"string","description":"El género facial de la persona en la imagen.","enum":["None","Male","Female"]},"FacialMask":{"type":"number","description":"La probabilidad de mascarilla facial.","minimum":0,"maximum":1},"FaceConfidence":{"type":"number","description":"Confianza predicha del rostro.","minimum":0,"maximum":1},"BadRequestResult":{"type":"object","description":"Resultado cuando llegan parámetros incorrectos en la solicitud.","properties":{"status":{"type":"number"},"error":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}},"TimeStamp":{"type":"string","description":"Un valor de fecha y hora en formato \"%Y-%m-%dT%H:%M:%SZ\"."},"ExceptionResult":{"type":"object","description":"Se ha producido un error en la llamada al backend de SelphID-SDK.","properties":{"status":{"type":"number"},"error":{"type":"string"},"exception":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}}}},"paths":{"/api/v1/selphid/authenticate-facial/images":{"post":{"description":"Autentica dos plantillas faciales, obtenidas a partir de dos búferes de imagen.","tags":["Authentication"],"requestBody":{"description":"Json con las imágenes de entrada en formato base64.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacialAuthenticationImages"}}}},"responses":{"200":{"description":"Resultado de la autenticación facial.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacialAuthenticationResult"}}}},"400":{"description":"Parámetros incorrectos en la solicitud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResult"}}}},"500":{"description":"Se ha producido un error en la llamada al backend de SelphID-SDK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionResult"}}}}}}}}}
```