生成音乐

POST

https://suno.x-mi.cn/apiclouds/v1/suno/generate

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

x-apiid

string

必需

示例值:

155358095076248003

x-token

string

必需

示例值:

sk-1E04222C99044971AEA4C850D95F6B0F

Body 参数application/json

action

string

动作，generate=生成，continue=续写, whole=获取整首，cover=翻唱，persona=根据角色生成

必需

makeInstrumental

integer

是否纯音乐，1是，0否

必需

mvVersion

string

音乐模型版，有3个版本 chirp-v3-0;chirp-v3-5;chirp-v4

必需

inputType

string

输入类型， 10灵感，20=自定义

必需

title

string

标题

可选

lyric

string

歌词（灵感和歌词二选一）

可选

style

string

歌曲风格

可选

excludeStyle

string

排除的歌曲风格

可选

idea

string

灵感提示，inputType=10则必填（灵感和歌词二选一）

可选

continueClipId

string

续写，翻唱Id，只有action=continue、cover、whole、persona才有值，action=persona时传入创建返回的角色Id,另外合并（whole）整首的时候只需填写此字段，其他不用填

可选

continueAt

string

续写时间，只有action=continue才有值

可选

示例

{
    "inputType": 10,
    "mvVersion": "chirp-v3-alpha",
    "makeInstrumental": 0,
    "action": "generate",
    "idea": "一首 80s 歌曲， disco , rap 的风格混搭"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://suno.x-mi.cn/apiclouds/v1/suno/generate' \
--header 'x-apiid: 155358095076248003' \
--header 'x-token: sk-1E04222C99044971AEA4C850D95F6B0F' \
--header 'Content-Type: application/json' \
--data-raw '{
    "inputType": 10,
    "mvVersion": "chirp-v3-alpha",
    "makeInstrumental": 0,
    "action": "generate",
    "idea": "一首 80s 歌曲， disco , rap 的风格混搭"
}'

返回响应

🟢200成功

application/json

Body

code

integer

消息编码，0为成功，非0为失败

必需

msg

string

消息描述

必需

data

object

必需

string

任务查询id

必需

success

boolean

必需

示例

{"id":"1223445688"}

修改于 2025-04-22 03:45:41

任务查询