Saltar al contenido principal
POST
Escaneo de deepfake
Este punto final no descarga ni inspecciona la imagen, el video o el documento referenciados. Califica los indicadores o las puntuaciones proporcionadas por su aplicación. Los valores son puntuaciones de riesgo heurísticas, no probabilidades calibradas. La etiqueta authentic significa que no se alcanzó el umbral de riesgo configurado; no es prueba de que el medio sea auténtico, especialmente cuando no se proporcionaron indicadores.

Cómo funciona la detección

Los escaneos utilizan un motor de señal heurístico (heuristic_v1) que acepta señales proporcionadas por el llamador (de modelos de ML externos, motores de reglas o revisión manual) y las asigna a puntuaciones ponderadas:
  • Indicadores de deepfake: intercambio de caras, iluminación inconsistente, artefactos de compresión, inconsistencia temporal, falta de coincidencia de metadatos
  • Indicadores de suplantación de identidad: falta de coincidencia biométrica, falta de coincidencia de nombre, falta de coincidencia de documento de identidad, violación de confianza del emisor
Las puntuaciones ≥ 75 establecen el veredicto deepfake o impersonation. Las puntuaciones ≥ 40 establecen suspect. Las puntuaciones ≥ 60 ingieren automáticamente una señal de riesgo. También puede omitir el análisis heurístico pasando directamente los valores deepfake_score y impersonation_score precalculados. La plataforma sigue aplicando los mismos umbrales de veredicto y la ingesta automática de señales. Consulte la guía de detección de deepfake para conocer el flujo de trabajo completo, la referencia de indicadores y ejemplos adicionales.

Respuesta

string
UUID del resultado del escaneo.
string
La referencia del sujeto que fue escaneada.
string
Tipo de sujeto: image, video, document, attestation, identity
integer
Puntuación de riesgo heurística de deepfake (0–100).
integer
Puntuación de riesgo heurística de suplantación (0–100).
string
authentic | suspect | deepfake | impersonation
array
Lista de indicadores activados del escaneo.
string
Modelo de detección utilizado (por ejemplo, heuristic_v1).
string
UUID de la señal de riesgo auto-ingestada (solo presente cuando la puntuación es ≥ 60).
string
UUID de la atestación vinculada, si se proporcionó una durante el escaneo.
string
Marca de tiempo ISO 8601 de cuándo se realizó el escaneo.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
subject_ref
string
requerido

Identificador de referencia para el sujeto

subject_type
string
requerido
attestation_id
string
deepfake_score
integer | null
impersonation_score
integer | null
signals
string[]

Respuesta

Escaneo iniciado

scan_id
string
status
string
subject_ref
string