Skip to main content
POST
Cadence Cover

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be cadence-cover.

Available options:
cadence-cover
audio_url
string<uri>
required

The original song. A public https:// link to an audio file (mp3, m4a, wav, flac, ogg; a video link uses its audio track), 5 to 360 seconds, up to 20 MB. mp3 or m4a is recommended: a full 6-minute song fits, while wav over about 1 minute 50 seconds or flac over about 3.5 minutes exceeds the limit. Its length is measured before the task is accepted and is the billed length.

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 over the original melody, with \n between lines. Section tags such as [Verse] and [Chorus] are recommended. Max 4000 characters.

Maximum string length: 4000
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