Download a track
download_trackGet a download link for the final file. This spends Tuney credits (mp3, wav, or a zip of stems).
Returns download_url right away when the file is cached, otherwise a task_id to pass to
wait_for_task with kind="download". Links expire, so share them promptly. download_url is on
the Tuney API host; download_direct_url is the same file in Cloud Storage.
For format="stems" the link is a zip with one mp3 per part; the result's `contents` map
gives the readable name of each file (melody, chords, bass, drums, swoosh fx, impact fx).
To show stems to the user: fetch the zip, unzip it, rename the files with that map and
attach them. Never download the same track twice.
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": {
"cue_id": "<cue_id>"
},
"name": "download_track"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cue_id | Yes | ||
| format | No | mp3 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||