AI Video Detection API

1. Submit the Video

Upload a video file directly to the API, or submit a video URL. The server will validate the file.

Submit via file upload

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

Example Request

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'

Face Swap model example

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'

Submit via URL

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

Example Request

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

Face Swap model example

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

Example Response

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

The response includes a unique video ID for tracking the detection status.

"User verification failed" (403)

Cause: Invalid or expired API key

Solution:

1. Verify your API key is correct
2. Check if your API key is active in your account
3. Try regenerating your API key

"Not enough credits" (403)

Cause: Insufficient credits for video processing

Solution:

1. Check your remaining credits using /check-user-credits
2. Purchase additional credits if needed

"Unsupported video type" (400)

Cause: File format not supported

Solution:

1. Convert the video to a supported format (MP4, MOV, AVI, MKV, WEBM)
2. Ensure the file extension and MIME type are correct

"File size exceeds limit" (400)

Cause: Video file is too large

Solution:

1. Compress, trim, or re-encode the video to reduce size (maximum 100MB)
2. Use a more efficient codec/container

"File size is too small" (400)

Cause: Video file is below minimum size requirement

Solution:

1. Use a larger video file (minimum 1KB)
2. Check if the file was corrupted during upload

"Invalid file type" (400)

Cause: File type validation failed (e.g., wrong MIME type or corrupted file)

Solution:

1. Ensure the file is a valid video format
2. Verify the MIME type matches the file extension
3. Re-export or re-encode the file if necessary

Invalid model value (422)

Cause: The model parameter is not generic or faceswap

Solution:

1. Omit model to use the default generic model
2. Set model to generic for general AI video detection
3. Set model to faceswap for Face Swap video detection

Video status "failed"

Cause: Processing failed (e.g., unreadable container, decode errors)

Solution:

1. Ensure the container/codec is commonly supported (H.264/AAC in MP4 recommended)
2. Re-encode the video using a standard preset (e.g., ffmpeg) and re-upload
3. Ensure the file meets size and format requirements
4. Contact support if the issue persists

"User not found"

Cause: Invalid user ID

Solution:

1. Verify your API key is correct and tied to an active account
2. Ensure the integration user is valid and active
3. Re-authenticate if needed

"File metadata could not be fetched" (500)

Cause: Unable to access or parse the uploaded file

Solution:

1. Verify the upload completed successfully
2. Check the file is accessible and not corrupted
3. Try re-uploading the file