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

# AI Music Detection

> AI music detection APIs - detect AI-generated music with clip-level verdicts and per-window vocal/instrumental breakdowns, batch and real-time streaming.

AI music detection determines whether a clip contains AI-generated music. Each window is independently scored for AI-generated vocals and AI-generated instrumental content, whenever it has enough of the corresponding content type to score - a window can carry both scores, one, or neither. Window results are aggregated into a clip-level `primary_verdict` of `ai-vocal-music`, `ai-instrumental`, or `not-ai-music`.

<Note>
  This is distinct from [music detection](/api-reference/music-detection/overview), which classifies audio as music, speech, or neither. AI music detection answers a different question: *is this music AI-generated?*
</Note>

| | Batch | Streaming |
| - | - | - |
| **Use case** | Classify a complete audio file | Real-time per-window classification |
| **Protocol** | HTTP POST | WebSocket |
| **Output** | Clip-level verdict plus per-window breakdown | Per-window vocal and instrumental AI results emitted progressively, final clip-level summary on completion |
| **Instrumental AI detection** | Included per window and clip-level | Included per window (live) and clip-level; the clip-level `done` result uses more audio context and is more reliable |

For a side-by-side comparison with the other Modulate capabilities, see [Which API should I use?](/guides/which-api).

## Authentication

Batch uses the `X-API-Key` header. Streaming uses an `api_key` query parameter at connection time. See [Authentication and rate limits](/guides/authentication).

## Performance notes

* Per-window results can be less accurate than the clip-level verdict and its confidence. Rely on the clip-level result when judging a whole song or segment.
* A window's vocal-AI and instrumental-AI scores are independent - a window can carry both, one, or neither, depending on how much of each content type it contains.
* Heavily processed or high-production tracks are sometimes mislabeled as AI-generated. This is a known gap targeted by future model updates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.