Create a song
tempolor_create_songGenerate a song with vocals with TemPolor's current song model (more than 30 languages, up to 5 minutes) from a style prompt and your lyrics, or lyrics TemPolor writes from the prompt; for music without vocals use tempolor_create_instrumental. Optionally sung by an artist voice (tempolor_list_artist_voices) or your cloned voice (tempolor_clone_voice), or built on your MIDI file (tempolor_upload_midi): one of these at most. A track counts against the plan's monthly tracks on Lite and Pro; Ultra has no monthly count but can be limited to about 300 songs a day per account; a 429 means the accounts are busy (tempolor_list_running_jobs). Waits up to ~50 s and returns the job_id, status and, once COMPLETED, a temporary mp3 url; else call tempolor_get_music. POST /music/song.
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": {
"prompt": "<prompt>"
},
"name": "tempolor_create_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the track to finish (default true); false returns the job_id at once. | |
| lyrics | No | Your lyrics, up to 3,000 characters. Left out, TemPolor writes lyrics from the prompt. | |
| prompt | Yes | What the song is: genre, mood, instruments, voice, subject. Up to 2,000 characters. | |
| maxJobs | No | The most jobs the account may run at once for this request, from 1. Default: the account's maxJobs (tempolor_list_accounts). | |
| user_id | No | The TemPolor account (user_id from tempolor_list_accounts) to run on. Omit to use the account that holds clonedVoiceItemId or midiItemId, else a healthy account with a free maxJobs slot. | |
| replyRef | No | Your own reference, included in every callback. Up to 1,024 characters. | |
| replyUrl | No | A callback URL that receives a POST with the job's tempolor_get_music record while the track is made and once it ends; a job not done within 60 minutes ends with code 408. Up to 1,024 characters. | |
| midiItemId | No | A MIDI file to build the song on: a midiItemId from tempolor_upload_midi or tempolor_list_midi; the song runs on the account that holds it. Not with a voice. | |
| model_song | No | The same values as the REST API; omit it for TemPolor's current song model. Models: https://useapi.net/docs/api-tempolor-v1#models. | v4.8 |
| artistVoiceItemId | No | An artist voice to sing the song: an itemId from tempolor_list_artist_voices. Not with clonedVoiceItemId or midiItemId. | |
| clonedVoiceItemId | No | Your cloned voice to sing the song: a clonedVoiceItemId from tempolor_clone_voice or tempolor_list_cloned_voices; the song runs on the account that holds it. Not with artistVoiceItemId or midiItemId. |