开始创作歌曲 - Open API 开发者文档

请求参数

Authorization

Header 参数

Authorization

string

可选

必填;从API后台秘钥管理处获得

示例值:

Bh3oi26r1FPFCMrJ59RKngSXB2

Body 参数multipart/form-data

callback_url

string

必需

必填。Webhook 回调 URL。图片生成完毕之后，生成结果将会以 POST 形式发送到此 Webhook URL。

示例值:

https://baidu.com

custom_mode

integer

必需

是否自定义模式,默认0为灵感模式;1-自定义模式

示例值:

0

make_instrumental

boolean

必需

是否纯音乐，默认不是纯音乐。若要为纯音乐，填1即可，例如：make_instrumental 1

示例值:

0

prompt

string

可选

描述词或自定义歌词,自定义模式至多1250字(一个中文算1个字),灵感模式至多200字(一个中文算1个字);传知名艺术家名称100%不会生成,比如周杰伦/郎朗

示例值:

美女

mv

string

可选

版本号,填写chirp-v3-5

示例值:

chirp-v3-5

title

string

歌名

可选

示例值:

歌名

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/suno/generate' \
--header 'Authorization: Bh3oi26r1FPFCMrJ59RKngSXB2' \
--form 'callback_url="https://baidu.com"' \
--form 'custom_mode="0"' \
--form 'make_instrumental="0"' \
--form 'prompt="美女"' \
--form 'mv="chirp-v3-5"' \
--form 'title="歌名"' \
--form 'tags=""' \
--form 'continue_at="60"' \
--form 'continue_clip_id="6bb8fbe4-09f6-4c2b-b945-fe4f026644c0"'

返回响应

🟢200成功

application/json

Body

string

可选

示例

{
  "code": 200,
  "msg": "成功",
  "data": [
    {
      "task_id": "f9761a3e-b396-4060-a35b-a26bbce7ba9b",
      "status": 1,
      "title": "",
      "prompt": "美女"
    },
    {
      "task_id": "f9761a3e-b396-4060-a35b-a26bbce7ba9b",
      "status": 1,
      "title": "",
      "prompt": "美女"
    }
  ],
  "exec_time": 0.659346,
  "ip": "182.129.131.225"
}

🟠400失败