Skip to main content
POST
Cadence Voice Cover

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be cadence-voice-cover.

Available options:
cadence-voice-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.

reference_audio_url
string<uri>
required

The target voice. A public https:// link to an audio file, at least 3 seconds of one clear voice, up to 20 MB.

pitch_shift
integer
default:0

Optional. Shift the converted vocal by this many semitones, -12 to 12. Accompaniment is not shifted.

Required range: -12 <= x <= 12
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