Skip to main content
POST
Suno Mashup

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be suno-mashup.

Available options:
suno-mashup
audio_urls
string<uri>[]
required

Required. Exactly 2 public audio URLs to blend.

Required array length: 2 elements
style
string
required

Required. Music style, e.g. lofi hip hop, mellow piano, rainy night. Max 1000 characters.

Maximum string length: 1000
title
string
required

Required. Song title. Max 80 characters.

Maximum string length: 80
lyrics
string

Optional. Lyrics for the mashup. 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
duration
integer

Optional. Target length in seconds, 10 to 360. Omit to let the model decide.

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