> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpique.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# audio_matching

> Checks whether audio matches a reference track

## Overview

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

## Configuration

<ParamField body="config.reference_audio" type="string" required>
  GCS URI of the reference audio file.

  **Allowed extensions:** mp3, wav, aac, flac
</ParamField>

## Example Configuration

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

## Result Schema

```json theme={null}
{
  "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.