Upload a song
create_songAdd a song: master audio, and square cover art if it has one Audio: MP3, WAV or M4A up to 250 MB. Cover (optional): a square JPEG or PNG, 1000–6000 px (3000×3000 recommended), up to 20 MB; it is kept at 1536, 640 and 160 px, not as uploaded. Without one the song has no cover (cover_art null) and every video still works; set_song_cover adds one later. The song is analyzed next (lyrics, beats, sections): poll get_song until analysis.status is "ready", usually about a minute. Pass lyrics (or set them later with set_song_lyrics) to have the videos spell every word right. The file’s tags fill what is left out: its title, ISRC, embedded lyrics and embedded cover (a square one, 1000 px or more). The same song already in the workspace (the same audio file, or the same ISRC) is refused with 409, code duplicate, and its song_id. A released song of a linked artist can be imported instead of uploaded (import_songs). Needs an active plan (402 plan_required without one; get_account: plan.active) and room in its storage (402 storage_full when it would not fit; get_account: storage).
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": "create_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | The song title; left out, the file’s title tag, then its file name | |
| lyrics | No | Optional. The song’s lyrics as text: plain (Suno-style [Verse]/[Chorus] tags and (x2) marks are fine), or the contents of an SRT, WebVTT or LRC file. Every word is still timed from the audio: your text fixes misheard words and sets where lines break in videos, and its section tags set the song’s sections (a chorus sung once is still a chorus). A part sung again (a chorus) can be written once; lyrics that don’t match what’s sung, or cover only part of it, are refused once the song is analyzed (get_song: analysis.lyrics.status "mismatch") | |
| language | No | Lyrics language (ISO 639-1, e.g. "en"); detected when omitted | |
| artist_id | No | The artist id. An artist workspace may leave it out: its songs are its artist's | |
| audio_url | No | A public https URL of the master audio (a file on your computer: create_upload, then its file_url) | |
| instrumental | No | Deprecated: the analysis hears whether a song has vocals (get_song: instrumental). true still skips transcription: lyric videos have no words and music videos never lip-sync (no lyrics with it). Stops working on 2027-04-30. | |
| cover_art_url | No | Optional: a public https URL of the square cover art (a file on your computer: create_upload's file_url, or upload it with the CLI). Leave it out for a song without cover art |