Suno Music
Lyrics / Inspo / Sounds / Tags
lyrics generation, inspo reference-audio generation, sounds effects, upsampleTags expansion
POST https://toapis.com/v1/music/generations/{operation}modelstringbodyrequiredFixed
"suno"lyrics — lyrics generation ($0.008)
promptstringbodyrequiredTheme or topic description
lyrics_modelstringbodyLyrics model:
classic / remi (optional)curl --request POST \
--url https://toapis.com/v1/music/generations/lyrics \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"suno","prompt":"a song about summer by the sea"}'inspo — inspired generation ($0.068, Max $0.136)
Generate a new song inspired by 1-4 reference tracks.
audio_urlsarraybodyrequired1-4 public audio URLs
max_modebooleanbodyMax tier (no
custom field; applies directly)Do not send
custom; the upstream rejects it.sounds — sound effects ($0.0096)
promptstringbodyrequiredEffect description
typestringbodyEffect type
bpmnumberbodyTempo (range 1-300)
keystringbodyMusical key
upsampleTags — tag expansion ($0.004)
Expand a short style tag into a detailed style description.
tagsstringbodyrequiredStyle tags, e.g.
"lo-fi chill beats"curl --request POST \
--url https://toapis.com/v1/music/generations/upsampleTags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"suno","tags":"lo-fi chill beats"}'Response
task_idstringTask ID
statusstringsubmitted