Skip to main content
POST
Submit Suno task

提交任务

灵感模式(custom: false,默认)下 prompt 为必填的歌曲描述。自定义模式(custom: true)下 prompt 填写歌词,并可添加 title、style、negative_tags、max_mode 与 duration。一个请求通常返回两首,任务成功后请从 result_urls 读取全部曲目。
网关每次请求收取 60 积分,开启 max_mode: true(仅自定义模式)为 120 积分,价格覆盖返回的所有曲目。具体积分以 /pricing 为准。

授权

Authorization
string
header
必填

Wizzx API key. This is not a JWT.

请求体

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

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
instrumental
boolean
默认值:false
version
enum<string>
默认值:v6

Case-insensitive. All versions cost the same.

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

可用选项:
Male,
Female
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>
必填