> ## 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 classified by its vocal and instrumental content, then 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 AI results emitted progressively, final clip-level summary on completion |
| **Instrumental AI detection** | Included per window and clip-level           | Clip-level only, in the final `done` message                                              |

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.
* Heavily processed or high-production tracks are sometimes mislabeled as AI-generated. This is a known gap targeted by future model updates.