Music Generation API

Song/music generation, extension, mashup, vocal separation and cover generation via Suno and KieAI ai-music-api.

bolt

This page is the music part of the Content Generation API.

/v1/music/generate is a semantic alias for music models. For full details, see video-api → Music Models.

Music Generation

POST /v1/music/generate

Starts a new song/music generation task (asynchronous).

Quick Example (Suno V4)

cURL

curl -X POST https://api.onysoft.com/v1/music/generate \
  -H "Authorization: Bearer sk-ony-YOUR-KEY" \
  -d '{
    "model": "suno-v4",
    "prompt": "Upbeat synthwave with catchy female vocals about summer nights"
  }'
            

Custom Mode (Style + Title + Vocal Gender)

cURL

curl -X POST https://api.onysoft.com/v1/music/generate \
  -H "Authorization: Bearer sk-ony-YOUR-KEY" \
  -d '{
    "model": "suno-v4",
    "prompt": "[Verse]\nIn the neon city lights tonight...",
    "custom_mode": true,
    "style": "synthwave, retro, atmospheric",
    "title": "Neon Nights",
    "vocal_gender": "female",
    "instrumental": false
  }'
            

Music Models

Model	Function
`suno-v4`	New song generation (V4)
`ai-music-api/generate`	New song generation (Suno behind the scenes)
`ai-music-api/extend`	Extend an existing song
`ai-music-api/mashup`	Combine 2 songs
`ai-music-api/sounds`	Sound effects
`ai-music-api/upload-and-cover-audio`	Generate a cover from existing audio
`ai-music-api/separate-vocals`	Vocal/instrument separation
`ai-music-api/create-music-video`	Generate a visual video for music
`ai-music-api/add-instrumental`	Add instrumentals to vocals
`ai-music-api/convert-to-wav-format`	MP3 → WAV conversion
`suno-add-vocals`	Add vocals to an instrumental
`suno-extend-music`	Extend a Suno track
`suno-generate-lyrics`	Lyrics generation
`suno-replace-music-section`	Replace a section of a song

Suno Parameters

Parameter	Type	Default	Description
`prompt`	string	—	Theme/lyrics (required)
`custom_mode`	bool	false	If true, style+title are active
`style`	string	—	Music style (only when custom_mode=true)
`title`	string	—	Song title (only when custom_mode=true)
`instrumental`	bool	false	true = instrumental without vocals
`vocal_gender`	string	—	"male" or "female"
`negative_tags`	string	—	Unwanted styles/elements

Status Lookup

cURL

curl https://api.onysoft.com/v1/music/status/vtask_mus123 \
  -H "Authorization: Bearer sk-ony-YOUR-KEY"
            