> ## 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.

# subtitles

> Checks for subtitle presence

## Overview

Detects subtitles and can enforce a minimum presence requirement.

## Configuration

<ParamField body="config.require_subtitles" type="boolean">
  If true, the detector fails when subtitles are missing or insufficient.
</ParamField>

## Example Configuration

```json theme={null}
{
  "detector_name": "subtitles",
  "config": {
    "require_subtitles": true
  }
}
```

## Result Schema

```json theme={null}
{
  "detector_name": "subtitles",
  "pass_check": true,
  "score": 1.0,
  "rationale": "Detected subtitles in 6 frames (Total items: 6)",
  "metrics": {
    "subtitles": [
      {
        "timestamp_sec": 1.6,
        "category": "subtitle",
        "description": "Hello world",
      }
    ],
    "num_subtitles": 6,
    "require_subtitles": true,
    "min_subtitle_frames": 3,
  },
  "timestamps": [1.6],
}
```

## Interpreting Results

* **num\_subtitles/frames\_with\_subtitles**: Quantity of detected subtitle evidence.
* **require\_subtitles/min\_subtitle\_frames**: Requirement rules for pass/fail.
* **subtitles**: Frame-level detections with locations when available.