Saltar para o conteúdo principal
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.
A API de deepfake e personificação avalia indicadores ou pontuações externas fornecidas por sua aplicação para um assunto referenciado. Ela não inspeciona a mídia ou o documento referenciado. Resultados que excedem o limite de risco criam automaticamente um sinal de risco, conectando sua evidência de detecção upstream ao pipeline do Firewall de Identidade Antifraude.
A detecção de deepfake faz parte do Firewall de Identidade Antifraude. Os resultados da varredura fluem para o mesmo pipeline de sinal de risco que outros sinais de fraude, para que você possa consultá-los e revisá-los na página do console Risco e Fraude > Sinais ou no endpoint de listagem de sinais.

Como funciona

1

Enviar uma digitalização

Envie uma solicitação POST para /v1/risk/deepfake/scan com uma referência de assunto e sinais indicadores brutos do seu pipeline de detecção ou pontuações pré-calculadas de um modelo externo.
2

Revisar o veredito

A resposta inclui pontuações de deepfake e personificação (0–100) e um veredito: authentic, suspect, deepfake ou impersonation.
3

Criação automática de sinais

Quando uma pontuação atinge 60 ou mais, a plataforma ingere automaticamente um sinal de risco na pipeline do seu locatário. A resposta inclui o signal_id para que você possa rastreá-lo.
4

Recuperar resultados mais tarde

Use GET /v1/risk/deepfake/results/{subject_ref} para buscar o resultado da varredura mais recente para qualquer assunto previamente varrido.

Pré-requisitos

  • Um inquilino Truthlocks ativo com uma chave de API
  • Referências de assunto para o conteúdo que você deseja escanear (URLs, hashes SHA-256, IDs de atestação ou identificadores opacos)

Escaneando um assunto

Envie uma digitalização com sinais indicadores do seu pipeline de detecção:
A resposta inclui pontuações, um veredito e (se o limite for atingido) um sinal de risco vinculado:

Modelo de detecção

A plataforma usa um mecanismo de sinal heurístico (heuristic_v1) que mapeia indicadores fornecidos pelo chamador para pontuações ponderadas. O mecanismo avalia 12 indicadores em duas categorias:

Indicadores de deepfake

Indicadores de personificação

Vereditos e limites

Cada varredura produz um veredito baseado na pontuação mais alta: Quando qualquer uma das pontuações atinge 60 ou mais, a plataforma cria automaticamente um sinal de risco. Você não precisa fazer uma chamada de API separada — o signal_id é retornado na resposta da varredura.

Usando pontuações pré-calculadas

Se você já tiver pontuações de um modelo ML externo ou serviço de detecção, passe-as diretamente para pular a análise heurística:
A plataforma ainda aplica os mesmos limites de veredito e ingestão automática de sinais, para que você obtenha uma classificação consistente, independentemente da fonte de detecção.

Vinculando varreduras a atestações

Associe uma digitalização a uma atestação existente para vincular os resultados da deteção à credencial a que se referem:
Isso facilita a sinalização e revisão de atestados suspeitos no console.

Recuperando resultados de varredura

Obtenha o resultado da análise mais recente para um assunto sem executar novamente a análise:

Tipos de assunto

O campo subject_type informa à plataforma que tipo de conteúdo está sendo escaneado:

Medição de uso

Cada solicitação de varredura de deepfake incrementa o contador de uso antifraud.deepfake_scans para o seu ciclo de faturamento. Você pode monitorar seu consumo de varredura com a API de uso ou no console em Configurações > Faturamento > Uso na seção Anti-Fraude.
As cotas de varredura de deepfake variam de acordo com o nível do plano. Consulte a visão geral de faturamento para obter detalhes sobre todos os produtos antifraude medidos.

O que vem a seguir