API de Detecção de Vídeo Gerado por IA

1. Enviar o Vídeo

Faça upload de um arquivo de vídeo diretamente para a API ou envie uma URL de vídeo. O servidor validará o arquivo.

Enviar via upload de arquivo

POST https://detect-video.truthscan.com/detect-file

Exemplo de Solicitação

curl -X POST \
  'https://detect-video.truthscan.com/detect-file' \
  -H 'accept: application/json' \
  -H 'key: YOUR-API-KEY-GOES-HERE' \
  -F 'file=@/path/to/video.mp4;type=video/mp4'

Exemplo com modelo Face Swap

curl -X POST \
  'https://detect-video.truthscan.com/detect-file' \
  -H 'accept: application/json' \
  -H 'key: YOUR-API-KEY-GOES-HERE' \
  -F 'file=@/path/to/video.mp4;type=video/mp4' \
  -F 'model=faceswap'

Enviar via URL

POST https://detect-video.truthscan.com/detect

Exemplo de Solicitação

curl -X POST \
  'https://detect-video.truthscan.com/detect' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "key": "YOUR-API-KEY-GOES-HERE",
  "url": "https://example.com/video.mp4",
  "model": "generic"
}'

Exemplo com modelo Face Swap

curl -X POST \
  'https://detect-video.truthscan.com/detect' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "key": "YOUR-API-KEY-GOES-HERE",
  "url": "https://example.com/video.mp4",
  "model": "faceswap"
}'

Exemplo de Resposta

{
  "id": "77565038-9e3d-4e6a-8c80-e20785be5ee9",
  "status": "pending"
}

A resposta inclui um ID único de vídeo para rastrear o status da detecção.

"Verificação de usuário falhou" (403)

Causa: Chave de API inválida ou expirada

Solução:

1. Verifique se sua chave de API está correta
2. Verifique se sua chave de API está ativa em sua conta
3. Tente regenerar sua chave de API

"Não há créditos suficientes" (403)

Causa: Créditos insuficientes para processamento de vídeo

Solução:

1. Verifique seus créditos restantes usando /check-user-credits
2. Compre créditos adicionais se necessário

"Tipo de vídeo não suportado" (400)

Causa: Formato de vídeo não suportado

Solução:

1. Converta o vídeo para um formato suportado (MP4, MOV, AVI, MKV, WEBM)
2. Certifique-se de que a extensão do arquivo e o tipo MIME estão corretos

"Tamanho do arquivo excede o limite" (400)

Causa: Arquivo de vídeo muito grande

Solução:

1. Comprima, corte ou re-codifique o vídeo para reduzir o tamanho (máximo 100MB)
2. Use um codec/container mais eficiente

"Tamanho do arquivo é muito pequeno" (400)

Causa: Arquivo de vídeo está abaixo do requisito de tamanho mínimo

Solução:

1. Use um arquivo de vídeo maior (mínimo 1KB)
2. Verifique se o arquivo foi corrompido durante o upload

"Tipo de arquivo inválido" (400)

Causa: Validação do tipo de arquivo falhou (por exemplo, tipo MIME incorreto ou arquivo corrompido)

Solução:

1. Certifique-se de que o arquivo é um formato de vídeo válido
2. Verifique se o tipo MIME corresponde à extensão do arquivo
3. Re-exporte ou re-codifique o arquivo se necessário

Valor de model inválido (422)

Causa: O parâmetro model não é generic ou faceswap

Solução:

1. Omita model para usar o modelo generic padrão
2. Defina model como generic para detecção geral de vídeo IA
3. Defina model como faceswap para detecção de vídeos Face Swap

Status "falhou" do vídeo

Causa: Processamento falhou (por exemplo, container ilegível, erros de decodificação)

Solução:

1. Certifique-se de que o container/codec é comumente suportado (H.264/AAC em MP4 recomendado)
2. Re-codifique o vídeo usando um preset padrão (por exemplo, ffmpeg) e re-envie
3. Certifique-se de que o arquivo atende aos requisitos de tamanho e formato
4. Entre em contato com o suporte se o problema persistir

"Usuário não encontrado"

Causa: ID de usuário inválido

Solução:

1. Verifique se sua chave de API está correta e vinculada a uma conta ativa
2. Certifique-se de que o usuário de integração é válido e ativo
3. Re-autentique se necessário

"Metadados do arquivo não puderam ser obtidos" (500)

Causa: Incapaz de acessar ou analisar o arquivo enviado

Solução:

1. Verifique se o upload foi concluído com sucesso
2. Verifique se o arquivo está acessível e não está corrompido
3. Tente re-enviar o arquivo