Skip to main content
POST
Submit Suno task

Submit task

In inspiration mode (custom: false, default) prompt is a required song description. In custom mode (custom: true) prompt holds the lyrics and you can add title, style, negative_tags, max_mode, and duration. One request usually returns two tracks; read all of them from result_urls when the task succeeds.
The gateway charges 60 credits per request, or 120 credits with max_mode: true (custom mode only). The price covers every returned track. Read /pricing for the current amount.

Authorizations

Authorization
string
header
required

Wizzx API key. This is not a JWT.

Body

application/json

Music generation. Inspiration mode (custom=false) takes a song description in prompt. Custom mode (custom=true) takes lyrics in prompt plus optional title, style, negative_tags, max_mode, and duration. One request usually returns 2 tracks in result_urls. Billed per request; max_mode doubles the price.

prompt
string
required

Inspiration mode: required song description, at most 3000 characters. Custom mode: lyrics, at most 5000 characters; required unless instrumental is true.

Required string length: 1 - 3000
custom
enum<boolean>
default:false
Available options:
false
max_mode
enum<boolean>
default:false

Custom mode only. Higher quality at double the price.

Available options:
false
instrumental
boolean
default:false
version
enum<string>
default:v6

Case-insensitive. All versions cost the same.

Available options:
v6,
v6-wild,
v6-mini
title
string

Custom mode only.

Maximum string length: 80
style
string

Custom mode only. Style tags.

Maximum string length: 1000
negative_tags
string

Custom mode only. Styles to avoid.

Maximum string length: 1000
vocal_gender
enum<string>

Case-insensitive; m and f are accepted. Cannot be combined with instrumental=true.

Available options:
Male,
Female
duration
integer

Custom mode only. Target length in seconds; actual length may differ. Does not change the price.

Required range: 10 <= x <= 360

Response

Task accepted

code
enum<integer>
required
Available options:
0
message
string
required
Example:

"success"

data
object
required
request_id
string<uuid>
required