Skip to main content
POST
Suno Extend

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be suno-extend.

Available options:
suno-extend
task_id
string

The img_uuid of one of your earlier successful Suno tasks that produced songs (suno-v6, suno-extend, suno-cover, suno-add-vocals, suno-add-instrumental, suno-replace-section or suno-mashup). Must be sent together with audio_id.

audio_id
string

The audio_id of the song to use, taken from that task's result (json[].audio_id). Must be sent together with task_id.

audio_url
string<uri>

Alternative to task_id + audio_id: a public URL of your own audio to extend (up to 8 minutes).

continue_at
number

Optional. Second in the source where the continuation starts. Must be greater than 0 and less than the source length.

variant
enum<string>
default:standard

Optional. When extending one of your Suno songs, the source's variant is used automatically and a different value is rejected (Suno requires the same version). When extending an uploaded file, defaults to standard.

Available options:
standard,
mini,
wild
instrumental
boolean
default:false

true = no vocals. When true, lyrics, vocal_gender and audio_weight must not be sent.

title
string

Optional. Song title. Max 100 characters.

Maximum string length: 100
style
string

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

Maximum string length: 1000
lyrics
string

Optional. Lyrics for the new part. Use section markers such as [Verse] and [Chorus]. Max 5000 characters.

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