Skip to main content

​
Overview

Checks whether the video’s audio matches a provided reference audio file.

​
Configuration

​
config.reference_audio
string
required
GCS URI of the reference audio file.Allowed extensions: mp3, wav, aac, flac

​
Example Configuration

{
  "detector_name": "audio_matching",
  "config": {
    "reference_audio": "gs://judge-artifacts/org_123/reference_uploads/abc/reference_song.mp3"
  }
}

​
Result Schema

{
  "detector_name": "audio_matching",
  "pass_check": true,
  "score": 0.92,
  "rationale": "Audio matches reference audio (similarity: 92.0%). Match found at 12.4s in reference audio.",
  "metrics": {
    "similarity": 0.92,
  }
}

​
Interpreting Results

  • similarity: Match score against the reference audio; compared to threshold for pass/fail.
  • time_offset_sec: Where the best match begins within the reference audio (if found).
  • clip_duration_sec/ref_duration_sec: Durations used to contextualize the match.