Skip to main content
POST
Cadence Song

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be cadence-song.

Available options:
cadence-song
style
string
required

Describe the music: language, genre, instruments, vocal, mood and tempo, comma-separated works best, e.g. Mandarin pop, warm female vocal, piano, strings, 90 BPM, emotional. Max 1000 characters.

Maximum string length: 1000
lyrics
string
required

Lyrics to sing, with \n between lines. Section tags such as [Verse], [Chorus], [Bridge], [Intro], [Outro] are recommended. Chinese and English are supported. Max 4000 characters.

Maximum string length: 4000
duration
integer
required

Required. Maximum length of the song in seconds, 10 to 360. This is the billed length: you pay for duration seconds even when the song ends earlier.

Required range: 10 <= x <= 360
seed
integer

Optional. The same seed and inputs give the same result. Random when omitted.

Required range: 0 <= x <= 2147483647
output_format
enum<string>
default:mp3

mp3 (320 kbps, default) or wav (16-bit). 48 kHz stereo.

Available options:
mp3,
wav
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required