Skip to main content
POST
Submit Suno task

Submit task

This endpoint is identical to POST /api/v1/music/generate and remains supported. Use music actions for new integrations: they cover generation plus extending, covering, editing, stem separation, analysis, and downloads. 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, auto_lyrics, persona_task_id, max_mode, and duration. Fields that generate does not accept return HTTP 422. One request usually returns two tracks; when the task succeeds, read all of them from result_urls or result.tracks.
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.

Headers

Idempotency-Key
string

Optional unique key (max 128 chars) to safely deduplicate retries for 24 hours without double-charging.

Maximum string length: 128

Body

application/json

Legacy entry for Suno music generation; identical to POST /api/v1/music/generate. Inspiration mode (custom=false) takes a song description in prompt. Custom mode (custom=true) takes lyrics in prompt plus optional title, style, negative_tags, auto_lyrics, persona_task_id, max_mode, and duration. One request usually returns 2 tracks. 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
auto_lyrics
enum<boolean>
default:false

Custom mode only.

Available options:
false
instrumental
boolean
default:false

No vocals. A custom-mode instrumental needs prompt or style.

version
enum<string>
default:v6

Case-insensitive. All versions cost the same. Cannot be combined with custom_model_task_id.

Available options:
v6,
v6-wild,
v6-mini
custom_model_task_id
string<uuid>

task_id of your SUCCEEDED create-model task. Replaces version; cannot be combined with version or persona_task_id.

persona_task_id
string<uuid>

task_id of your SUCCEEDED persona or create-voice task. Custom mode only.

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
style_weight
number

How strongly to follow style, 0-1. Custom mode only on actions other than generate.

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

How experimental the result is, 0-1.

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

How closely to follow the source audio, 0-1. Custom mode only on actions other than generate.

Required range: 0 <= x <= 1
vocal_gender
enum<string>

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

Available options:
Male,
Female
variety
enum<string>
Available options:
off,
normal,
high,
extra,
max
audio_format
enum<string>
Available options:
mp3,
m4a,
wav
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