> 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-pt-br/sdks/backend-sdk/selphid/technical_documentation/api_reference/passive-liveness/api-v1-selphid-passive-liveness-evaluate.md).

# /api/v1/selphid/passive-liveness/evaluate

Evalúa la prueba de vida pasiva de una imagen en bruto.

```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":{"PassiveLivenessImage":{"type":"object","description":"Una imagen en bruto, utilizada para la prueba de vida pasiva. Además, admite _extraData_, para el registro en Api Tracking.","properties":{"image":{"$ref":"#/components/schemas/ImageBuffer"},"extraData":{"$ref":"#/components/schemas/ExtraData"},"options":{"$ref":"#/components/schemas/SdkOptions"}},"required":["image"]},"ImageBuffer":{"type":"string","description":"Búfer en bruto de imagen en .png, .jpg o .bmp, codificado en base64."},"ExtraData":{"type":"string","description":"Datos tokenizados para llamar al servicio Api Tracking tras la operación, codificados 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"]},"PassiveLivenessResult":{"type":"object","description":"El resultado de una operación de prueba de vida pasiva.","properties":{"diagnostic":{"$ref":"#/components/schemas/FacialLivenessDiagnostic"},"noLiveDetails":{"$ref":"#/components/schemas/NoLiveDetails"},"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"}}},"FacialLivenessDiagnostic":{"type":"string","description":"Posibles resultados de una operación de prueba de vida.","enum":["None","Spoof","Uncertain","Live","NoneBecauseBadQuality","NoneBecauseFaceTooClose","NoneBecauseFaceNotFound","NoneBecauseFaceTooSmall","NoneBecauseAngleTooLarge","NoneBecauseImageDataError","NoneBecauseInternalError","NoneBecauseImagePreprocessError","NoneBecauseTooManyFaces","NoneBecauseFaceTooCloseToBorder","NoneBecauseFaceCropped","NoneBecauseLicenseError","NoneBecauseFaceOccluded","NoLive","NoneBecauseEyesClosed","NoneBecauseEyesOccluded","NoneBecauseTokenDataError","NoneBecauseTokenSecurity"]},"NoLiveDetails":{"type":"object","description":"Detalles para el caso FacialLivenessDiagnostic::NoLive","properties":{"mainCause":{"$ref":"#/components/schemas/NoLiveMainCause"},"fPadStatus":{"$ref":"#/components/schemas/FPadStatus"},"fPadScore":{"$ref":"#/components/schemas/FPadScore"},"fMadStatus":{"$ref":"#/components/schemas/FMadStatus"},"fMadScore":{"$ref":"#/components/schemas/FMadScore"},"coercionScore":{"$ref":"#/components/schemas/CoercionScore"},"reasonMessage":{"$ref":"#/components/schemas/NoLiveReasonMessage"}}},"NoLiveMainCause":{"type":"string","description":"Causa principal de alto nivel del diagnóstico NoLive.","enum":["FPadFailed","FMadFailed","MultipleFailed","Unknown"]},"FPadStatus":{"type":"string","description":"Estado de la detección facial de ataques de presentación (fPAD).","enum":["NotEvaluated","Passed","Failed","Error"]},"FPadScore":{"type":"number","description":"Puntuación fPAD normalizada, si está disponible","minimum":0,"maximum":1},"FMadStatus":{"type":"string","description":"Estado de la detección facial de ataques de manipulación (fMAD).","enum":["NotEvaluated","Passed","Failed","Error"]},"FMadScore":{"type":"number","description":"Puntuación fMAD normalizada, si está disponible","minimum":0,"maximum":1},"CoercionScore":{"type":"number","description":"Puntuación de coerción normalizada, si está disponible","minimum":0,"maximum":1},"NoLiveReasonMessage":{"type":"string","description":"Mensaje del motivo legible por humanos, para registros/backoffice."},"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."},"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/passive-liveness/evaluate":{"post":{"description":"Evalúa la prueba de vida pasiva de una imagen en bruto.","tags":["Passive Liveness"],"requestBody":{"description":"Json con un búfer de imagen, en formato base64.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PassiveLivenessImage"}}}},"responses":{"200":{"description":"Resultado de la prueba de vida pasiva.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PassiveLivenessResult"}}}},"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"}}}}}}}}}
```