Analyse a track for AI music signals
jj_ai_music_analyzeStart AI music detection on a local audio file or supported link, then track the asynchronous job to get a signal-based report. Supports path, base64, Spotify, ISRC, or direct audio URL.
Instructions
Starts an AI music detection (POST /ai-music/jobs) on a local audio file (path, or base64 content: 100 MB and 600 seconds at most), OR on exactly one link: "url" (Spotify track link), "spotifyTrackId", "isrc" or "audioUrl" (direct audio link; YouTube is not supported; a Spotify or ISRC source may only provide an excerpt, see result.primary.audioSource). Links only work when jj_ai_music_availability reports links=true. Asynchronous: returns at once with a job (pass maxWaitMs to wait), then follow it with jj_ai_music_get_job. One unfinished analysis per account at a time (409), results kept 90 days, no audio kept. Needs the audio:write scope. Consumes one unit of the ai-music counter (free 5/day and 50/month, Premium 30/day and 300/month, UTC; failures refunded); a 429 states when it resets, a 413 means the file is too large or too long. The report is an aggregated index of signals, not a probability and not proof of origin: present it as such.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "jj_ai_music_analyze"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Spotify track link. Exclusive with every other source. | |
| isrc | No | ISRC code of the recording. Exclusive with every other source. | |
| path | No | Absolute or relative local path to the audio file. Exclusive with contentBase64 and the link fields. | |
| audioUrl | No | Direct link to an audio file. Exclusive with every other source. | |
| filename | No | File name (with extension). Required with contentBase64; defaults to the basename of "path". | |
| maxWaitMs | No | Wait up to this long (milliseconds, cap 600000) for the analysis to finish. Default 0: return at once. | |
| contentBase64 | No | Base64-encoded audio. Exclusive with path and the link fields. Requires "filename". | |
| spotifyTrackId | No | Spotify track id. Exclusive with every other source. |