v1

latestOpenAPI 3.1.02026-07-2662954.6 KB
Reports by Modality

Video

Analyze a video file to determine if it contains AI-generated content.

This endpoint analyzes both the video and audio components of the file, providing separate confidence scores for AI-generated video, voice, and music. It can also optionally detect deepfake video content when explicitly requested.

Caveats:

  • This endpoint can take up to two minutes for longer video files or if our backend is spinning up additional processing nodes. Please set a 120 second timeout in your client.
  • This endpoint is synchronous and will only analyze a portion of the content for longer duration videos. The response includes the duration tested. For videos longer than 30 seconds, we recommend breaking them into 30-second segments on the client side for complete analysis.
  • Due to a limitation in our document provider, the playground only supports small files of up to 10MB. This limit does not apply when using the API directly.
post/v2/video/sync

Query parameters

excludingstring[]

Array of analysis types to exclude. Valid values are ai_video, ai_music, ai_voice, deepfake_video.

onlystring[]

Array of analysis types to include. Valid values are ai_video, ai_music, ai_voice, deepfake_video. Note: deepfake_video is OFF by default and must be explicitly included using this parameter if you want deepfake detection.

external_idstring nullable

An optional external identifier for tracking this video analysis.

Response

Successful Response

idstring uuid required
external_idstring nullable

The external identifier provided in the request, if any.

created_atstring date-time

Example response

{
  "report": {
    "ai_video": {
      "confidence": 0.95
    },
    "ai_voice": {
      "confidence": 0.95
    },
    "ai_music": {
      "confidence": 0.95
    },
    "deepfake_video": {
      "is_detected": true,
      "confidence": 0.936413076150301
    },
    "meta": {
      "duration": 120,
      "total_bytes": 362594,
      "md5": "db36d923800f6ca6b7f87cff8a19d1d1",
      "audio": "processed",
      "video": "processed"
    }
  }
}