生成音乐（Suno自定义模式）

正式环境

https://api.302.ai

POST

/suno/submit/music

通过自定义歌曲的歌词、风格等设置，生成2首歌曲。

使用说明

参数要求

根据 make_instrumental 参数的不同，需要提供的参数也不同：

纯音乐模式 (make_instrumental: true)

必需参数：tags（风格）、title（标题）、mv（模型）

可选参数：negative_tags、metadata

带歌词模式 (make_instrumental: false)

必需参数：prompt（歌词）、tags（风格）、title（标题）、mv（模型）

可选参数：negative_tags、metadata

字符长度限制

不同模型版本有不同的字符限制：

模型版本	prompt（歌词）限制	tags（风格）限制
chirp-v3-5, chirp-v4	3000字符	200字符
chirp-auk, chirp-bluejay, chirp-crow	5000字符	1000字符

title（标题）：所有模型统一限制为 80字符

回调机制

任务处理过程中会触发三个阶段的回调：

text - 文本生成完成

first - 第一首歌曲完成

complete - 全部歌曲完成

注意事项

⚠️ 新用户推荐使用全自动模式快速测试

📅 生成的文件将保留 14天 后自动删除

✅ 请根据 make_instrumental 设置提供所有必要参数

📏 注意遵守 prompt、tags 和 title 的字符长度限制

🔄 可使用查询任务接口主动检查任务状态

定价

0.1 PTC/次

请求参数

Header 参数

Body 参数application/json必填

示例

带歌词的流行歌曲（推荐）纯音乐钢琴曲简单的摇滚歌曲

使用最新的 chirp-crow (v5) 模型生成一首带有完整歌词的流行歌曲

{
    "prompt": "[Verse]\n月光映山河\n清风拂柳枝\n心中千言万语\n只想诉与你\n\n[Verse 2]\n花开又花落\n春去秋回来\n岁月无情流转\n唯爱永留心间\n\n[Chorus]\n一生一世\n与你共舞风雨\n不离不弃\n共度春夏冬秋\n\n[Bridge]\n多少次\n梦中相依偎\n醒来时\n泪湿枕畔\n\n[Chorus]\n一生一世\n与你共舞风雨\n不离不弃\n共度春夏冬秋\n",
    "tags": "pop, ballad, emotional, chinese",
    "mv": "chirp-crow",
    "title": "不离不弃",
    "make_instrumental": false,
    "metadata": {
        "create_mode": "custom",
        "vocal_gender": "f",
        "control_sliders": {
            "style_weight": 0.87,
            "weirdness_constraint": 0.75
        },
        "can_control_sliders": [
            "style_weight",
            "weirdness_constraint"
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

带歌词的流行歌曲（推荐）纯音乐钢琴曲简单的摇滚歌曲

curl --location --request POST 'https://api.302.ai/suno/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[Verse]\n月光映山河\n清风拂柳枝\n心中千言万语\n只想诉与你\n\n[Verse 2]\n花开又花落\n春去秋回来\n岁月无情流转\n唯爱永留心间\n\n[Chorus]\n一生一世\n与你共舞风雨\n不离不弃\n共度春夏冬秋\n\n[Bridge]\n多少次\n梦中相依偎\n醒来时\n泪湿枕畔\n\n[Chorus]\n一生一世\n与你共舞风雨\n不离不弃\n共度春夏冬秋\n",
    "tags": "pop, ballad, emotional, chinese",
    "mv": "chirp-crow",
    "title": "不离不弃",
    "make_instrumental": false,
    "metadata": {
        "create_mode": "custom",
        "vocal_gender": "f",
        "control_sliders": {
            "style_weight": 0.87,
            "weirdness_constraint": 0.75
        },
        "can_control_sliders": [
            "style_weight",
            "weirdness_constraint"
        ]
    }
}'

返回响应

🟢200成功

application/json

请求成功。任务已提交，系统将开始生成音乐。

返回的 data 字段包含任务ID，可用于后续查询任务状态。

Body

示例

{
    "code": 0,
    "message": "Success",
    "data": "task_1234567890abcdef"
}

🟠400

🟠401

🟠429

🔴500

修改于 2025-12-19 09:31:12

Music（Suno全自动模式）

Music（Suno歌曲续写）

生成音乐（Suno自定义模式）

使用说明#

参数要求#

字符长度限制#

回调机制#

注意事项#

定价#