Saltar para o conteúdo principal
POST
Verificação de deepfake
Este endpoint não baixa nem inspeciona a imagem, vídeo ou documento referenciado. Ele pontua indicadores ou pontuações fornecidas pelo seu aplicativo. Os valores são pontuações de risco heurísticas, não probabilidades calibradas. O rótulo authentic significa que o limite de risco configurado não foi atingido; não é prova de que a mídia é autêntica, especialmente quando nenhum indicador foi fornecido.

Como a detecção funciona

As verificações usam um mecanismo de sinal heurístico (heuristic_v1) que aceita sinais fornecidos pelo chamador (de modelos de ML externos, mecanismos de regras ou revisão manual) e os mapeia para pontuações ponderadas:
  • Indicadores de deepfake: troca de rosto, iluminação inconsistente, artefatos de compressão, inconsistência temporal, incompatibilidade de metadados
  • Indicadores de falsificação de identidade: incompatibilidade biométrica, incompatibilidade de nome, incompatibilidade de documento de identidade, violação de confiança do emissor
Pontuações ≥ 75 definem o veredito deepfake ou impersonation. Pontuações ≥ 40 definem suspect. Pontuações ≥ 60 ingerem automaticamente um sinal de risco. Você também pode ignorar a análise heurística passando diretamente os valores pré-computados de deepfake_score e impersonation_score. A plataforma ainda aplica os mesmos limites de veredito e ingestão automática de sinal. Consulte o guia de detecção de deepfake para o fluxo de trabalho completo, referência de indicadores e exemplos adicionais.

Resposta

string
UUID do resultado da varredura.
string
A referência do assunto que foi escaneada.
string
Tipo de assunto: image, video, document, attestation, identity
integer
Pontuação de risco heurística de deepfake (0–100).
integer
Pontuação de risco heurística de personificação (0–100).
string
authentic | suspect | deepfake | impersonation
array
Lista de indicadores acionados da varredura.
string
Modelo de detecção usado (por exemplo, heuristic_v1).
string
UUID do sinal de risco auto-ingerido (presente apenas quando a pontuação ≥ 60).
string
UUID da atestação vinculada, se uma foi fornecida durante a varredura.
string
Timestamp ISO 8601 de quando a varredura foi realizada.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
subject_ref
string
obrigatório

Identificador de referência para o sujeito

subject_type
string
obrigatório
attestation_id
string
deepfake_score
integer | null
impersonation_score
integer | null
signals
string[]

Resposta

Verificação iniciada

scan_id
string
status
string
subject_ref
string