Get a song
get_songOne song and its analysis status cover_art.url is the cover at up to 1536 px (JPEG; width and height describe it), preview_url a 640 px and thumbnail_url a 160 px WebP; cover_art is null for a song without cover art (it is optional). Image links are signed for 7 days and stay the same all day, so they can be cached. analysis.lyrics.status says whose words its videos show: "transcribed" (as heard), "checked" (your lyrics, timed from the audio; corrected, added and kept count what checking did), "waiting" (your lyrics, checked once the analysis finishes) or "mismatch" (your lyrics didn’t match what’s sung, so the transcription is used). brief: what the song is about as every director reads it (theme, tone, story, mood_arc by section, setting), null before the analysis; status writing while it is written (a song analysed without one has it started by this call: get it again in half a minute), edited true once the user corrected it (edit_song_brief).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"song_id": "<song_id>"
},
"name": "get_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| song_id | Yes | The song id |