Skip to main content
POST
Submit Suno task

提交任务

该接口等同于 POST /api/v1/music/generate,并继续提供支持。新接入请使用音乐动作:除生成外,还支持续写、翻唱、编辑、分轨、分析与下载。 灵感模式(custom: false,默认)下 prompt 为必填的歌曲描述。自定义模式(custom: true)下 prompt 填写歌词,并可添加 title、style、negative_tags、auto_lyrics、persona_task_id、max_mode 与 duration。传入 generate 不接受的字段会返回 HTTP 422。一个请求通常返回两首,任务成功后请从 result_urls 或 result.tracks 读取全部曲目。
网关每次请求收取 60 积分,开启 max_mode: true(仅自定义模式)为 120 积分,价格覆盖返回的所有曲目。具体积分以 /pricing 为准。

授权

Authorization
string
header
必填

Wizzx API key. This is not a JWT.

请求头

Idempotency-Key
string

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

Maximum string length: 128

请求体

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
必填

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>
默认值:false
可用选项:
false
max_mode
enum<boolean>
默认值:false

Custom mode only. Higher quality at double the price.

可用选项:
false
auto_lyrics
enum<boolean>
默认值:false

Custom mode only.

可用选项:
false
instrumental
boolean
默认值:false

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

version
enum<string>
默认值:v6

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

可用选项:
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.

必填范围: 0 <= x <= 1
weirdness
number

How experimental the result is, 0-1.

必填范围: 0 <= x <= 1
audio_weight
number

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

必填范围: 0 <= x <= 1
vocal_gender
enum<string>

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

可用选项:
Male,
Female
variety
enum<string>
可用选项:
off,
normal,
high,
extra,
max
audio_format
enum<string>
可用选项:
mp3,
m4a,
wav
duration
integer

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

必填范围: 10 <= x <= 360

响应

Task accepted

code
enum<integer>
必填
可用选项:
0
message
string
必填
示例:

"success"

data
object
必填
request_id
string<uuid>
必填