Skip to main content
POST
Suno Add Instrumental

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be suno-add-instrumental.

Available options:
suno-add-instrumental
audio_url
string<uri>
required

Required. Public URL of the vocal-only recording.

title
string
required

Required. Song title. Max 80 characters.

Maximum string length: 80
style
string
required

Required. Style of the backing track, e.g. lofi, jazzy chords, soft drums. Max 1000 characters.

Maximum string length: 1000
lyrics
string

Optional. The lyrics sung in the recording, to help align the arrangement. Use section markers such as [Verse] and [Chorus]. Max 5000 characters.

Maximum string length: 5000
variant
enum<string>
default:standard

Suno V6 flavor. standard = V6 (natural vocals, rich detail), mini = V6 Mini (lighter and faster), wild = V6 Wild (bolder, more experimental). All three cost the same.

Available options:
standard,
mini,
wild
negative_tags
string

Optional. Styles or traits to avoid, e.g. heavy metal, screaming. Max 200 characters.

Maximum string length: 200
vocal_gender
enum<string>

Optional. Preferred singer gender (m / f also accepted). This raises the probability; it is not guaranteed.

Available options:
male,
female
style_weight
number

Optional. How strictly to follow style, from 0 to 1 (rounded to 2 decimals).

Required range: 0 <= x <= 1
weirdness_constraint
number

Optional. How experimental the result may be, from 0 to 1 (rounded to 2 decimals).

Required range: 0 <= x <= 1
audio_weight
number

Optional. How much the result follows the audio features of the source, from 0 to 1 (rounded to 2 decimals). Not available when instrumental is true.

Required range: 0 <= x <= 1
variety
integer
default:1

Optional. How different the versions are from each other: 0 off, 1 normal (default), 2 high, 3 extra, 4 max.

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