Webhook response structure and field definitions for the Copyleaks AI Video Detection API.
The Copyleaks AI Video Detection API delivers results asynchronously via webhook. The payload contains time-based detection data for the audio and visual tracks, overall AI ratios, video metadata, and scan details.
Response properties
string
The version of the AI detection model used for the analysis.
object
Time-based AI detection results for the audio track. Positions and lengths are in milliseconds.
Show properties
array<integer>
Start positions (in ms) of AI-detected audio segments.
array<integer>
Durations (in ms) of AI-detected audio segments, corresponding to each value in starts.
object
Segments of the audio track that were not scored and are excluded from the AI ratio calculations.
Show properties
array<integer>
Start positions (in ms) of excluded audio ranges.
array<integer>
Durations (in ms) of excluded audio ranges.
object
Time-based AI detection results for the visual track. Positions and lengths are in milliseconds.
Show properties
array<integer>
Start positions (in ms) of AI-detected visual segments.
array<integer>
Durations (in ms) of AI-detected visual segments, corresponding to each value in starts.
object
Segments of the visual track that were not scored and are excluded from the AI ratio calculations.
Show properties
array<integer>
Start positions (in ms) of excluded visual ranges.
array<integer>
Durations (in ms) of excluded visual ranges.
object
Overall AI detection ratios calculated from the scored segments only. Segments listed in exclude are not included in any of these calculations.
Show properties
float
Ratio of AI-detected audio duration to total audible duration. Excluded audio ranges are not counted. Range: 0.0-1.0.
float
Ratio of AI-detected visual duration to total visible duration. Excluded visual ranges are not counted. Range: 0.0-1.0.
float
Combined AI ratio across both audio and visual tracks, relative to the total video duration. Range: 0.0-1.0.
boolean
Indicates whether the video was flagged as containing AI-generated content. Use this flag instead of interpreting the ratios yourself. For the exact score, see summary.overallAIRatio.
object
Information about the analyzed video.
Show properties
float
Total duration of the video in seconds.
object
Optional metadata extracted from the video file (e.g. C2PA provenance data).
Show properties
string
Timestamp (if available) indicating when the video was created.
string
The AI service or tool that created the video, if present in the metadata.
string
The application or device used to create the video, if available in the metadata.
string
A summary of how the video was generated, if available in the metadata.
object
Metadata about the scan operation itself.
Show properties
string
The unique identifier for this scan, provided by you in the request.
integer
The actual number of credits consumed by the scan.
integer
The expected number of credits for the scan.
string
The ISO 8601 timestamp indicating when the scan was created.