API de Detección de Vídeo Generado por IA

1. Enviar el Vídeo

Cargue un archivo de vídeo directamente a la API o envíe una URL de vídeo. El servidor validará el archivo.

Enviar mediante carga de archivo

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

Ejemplo de Solicitud

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'

Ejemplo con 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 mediante URL

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

Ejemplo de Solicitud

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"
}'

Ejemplo con 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"
}'

Ejemplo de Respuesta

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

La respuesta incluye un ID único de vídeo para rastrear el estado de la detección.

"Verificación de usuario fallida" (403)

Causa: Clave de API inválida o expirada

Solución:

1. Verifique que su clave de API sea correcta
2. Verifique si su clave de API está activa en su cuenta
3. Intente regenerar su clave de API

"No hay créditos suficientes" (403)

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

Solución:

1. Verifique sus créditos restantes usando /check-user-credits
2. Compre créditos adicionales si es necesario

"Tipo de vídeo no soportado" (400)

Causa: Formato de vídeo no soportado

Solución:

1. Convierta el vídeo a un formato soportado (MP4, MOV, AVI, MKV, WEBM)
2. Asegúrese de que la extensión del archivo y el tipo MIME sean correctos

"El tamaño del archivo excede el límite" (400)

Causa: El archivo de vídeo es demasiado grande

Solución:

1. Comprima, recorte o re-codifique el vídeo para reducir el tamaño (máximo 100MB)
2. Use un códec/contenedor más eficiente

"El tamaño del archivo es demasiado pequeño" (400)

Causa: El archivo de vídeo está por debajo del requisito de tamaño mínimo

Solución:

1. Use un archivo de vídeo más grande (mínimo 1KB)
2. Verifique si el archivo fue corrupto durante la carga

"Tipo de archivo inválido" (400)

Causa: La validación del tipo de archivo falló (por ejemplo, tipo MIME incorrecto o archivo corrupto)

Solución:

1. Asegúrese de que el archivo sea un formato de vídeo válido
2. Verifique que el tipo MIME coincida con la extensión del archivo
3. Re-exporte o re-codifique el archivo si es necesario

Valor de model inválido (422)

Causa: El parámetro model no es generic o faceswap

Solución:

1. Omita model para usar el modelo generic predeterminado
2. Establezca model como generic para detección general de vídeo IA
3. Establezca model como faceswap para detección de vídeos Face Swap

Estado "fallido" del vídeo

Causa: El procesamiento falló (por ejemplo, contenedor ilegible, errores de decodificación)

Solución:

1. Asegúrese de que el contenedor/códec sea comúnmente soportado (H.264/AAC en MP4 recomendado)
2. Re-codifique el vídeo usando un preset estándar (por ejemplo, ffmpeg) y vuelva a cargar
3. Asegúrese de que el archivo cumpla con los requisitos de tamaño y formato
4. Contacte al soporte si el problema persiste

"Usuario no encontrado"

Causa: ID de usuario inválido

Solución:

1. Verifique que su clave de API sea correcta y esté vinculada a una cuenta activa
2. Asegúrese de que el usuario de integración sea válido y activo
3. Re-autentique si es necesario

"No se pudieron obtener los metadatos del archivo" (500)

Causa: No se pudo acceder o analizar el archivo cargado

Solución:

1. Verifique que la carga se completó exitosamente
2. Verifique que el archivo sea accesible y no esté corrupto
3. Intente volver a cargar el archivo