Skip to content
EN

生成歌曲(上传歌曲二次创作)

方法: POST路径: /suno/submit/music

上传的初始化歌曲id

请求参数

Header 参数

text
accept
string
可选
示例:
*/*
content-type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

text
prompt
string
必需
mv
string
必需
title
string
必需
tags
string
必需
continue_at
integer
必需
continue_clip_id
string
必需
上传的初始化歌曲id
task
string
必需
upload_extend
make_instrumental
boolean
必需
示例
{
"prompt"
:
"歌词"
,
"tags"
:
""
,
"negative_tags"
:
""
,
"mv"
:
"chirp-v4"
,
"title"
:
"标题"
,
"continue_clip_id"
:
"ca94a97d-d3f2-4a63-aeee-ba3a43384bcd"
,
"continue_at"
:
10
,
"task"
:
"upload_extend"
}

请求示例代码

Shell

bash
curl --location --request POST '/suno/submit/music' \
--header 'accept: */*' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'content-type: application/json' \
--data-raw '{
  "prompt": "歌词",
  "tags": "",
  "negative_tags": "",
  "mv": "chirp-v4",
  "title": "标题",
  "continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
  "continue_at": 10,
  "task": "upload_extend"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

text
object

示例

json
{
    "clips": [
        {
            "allow_comments": true,
            "audio_url": "",
            "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
            "created_at": "2025-04-29T07:29:45.897Z",
            "display_name": "WhimsicalJPop3254",
            "entity_type": "song_schema",
            "flag_count": 0,
            "handle": "whimsicaljpop3254",
            "id": "853daa2c-fbf9-4cd0-a90a-e2b18c53c174",
            "is_handle_updated": false,
            "is_liked": false,
            "is_public": false,
            "is_trashed": false,
            "major_model_version": "v4",
            "metadata": {
                "can_remix": true,
                "edited_clip_id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
                "history": [
                    {
                        "continue_at": 123,
                        "id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
                        "infill": false,
                        "source": "web",
                        "type": "gen"
                    }
                ],
                "infill": false,
                "is_remix": false,
                "priority": 10,
                "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
                "stream": true,
                "tags": "romantic raga",
                "task": "extend",
                "type": "gen"
            },
            "model_name": "chirp-v4",
            "play_count": 0,
            "status": "submitted",
            "title": "Cat Dance",
            "upvote_count": 0,
            "user_id": "e1f7ab94-b6ec-4a1a-b2bb-c3ca772a956d",
            "video_url": ""
        },
        {
            "allow_comments": true,
            "audio_url": "",
            "avatar_image_url": "https://cdn1.suno.ai/defaultOrange.webp",
            "created_at": "2025-04-29T07:29:45.897Z",
            "display_name": "WhimsicalJPop3254",
            "entity_type": "song_schema",
            "flag_count": 0,
            "handle": "whimsicaljpop3254",
            "id": "10df3c14-c755-40e9-87d8-830bfe3c3b9c",
            "is_handle_updated": false,
            "is_liked": false,
            "is_public": false,
            "is_trashed": false,
            "major_model_version": "v4",
            "metadata": {
                "can_remix": true,
                "edited_clip_id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
                "history": [
                    {
                        "continue_at": 123,
                        "id": "4c4c80c4-6318-48c7-a314-71dd03ba3a11",
                        "infill": false,
                        "source": "web",
                        "type": "gen"
                    }
                ],
                "infill": false,
                "is_remix": false,
                "priority": 10,
                "prompt": "[Verse]\nMove your paws\nLeft and right\nJump around\nFeel the light\nWhiskers twitch\nTails in the air\nDancing cats\nEverywhere\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Verse 2]\nTiptoe steps\nSoft and sweet\nTiny paws\nUnbeatable beat\nMeow to the rhythm\nClaws precise\nEvery move\nFeline paradise\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow\n\n[Bridge]\nOoh-ooh\nBounce and sway (ooh-ooh!)\nMoonlit grooves\nNight turns to day\nLean and stretch\nStrike your pose\nEvery kitty steals the show\n\n[Chorus]\nCat dance\nOh\nLet's go!\nSwing your tails\nDon’t say no (don’t say no!)\nPurr and twirl\nLike a show\nCat dance\nLet's steal the glow",
                "stream": true,
                "tags": "romantic raga",
                "task": "extend",
                "type": "gen"
            },
            "model_name": "chirp-v4",
            "play_count": 0,
            "status": "submitted",
            "title": "Cat Dance",
            "upvote_count": 0,
            "user_id": "e1f7ab94-b6ec-4a1a-b2bb-c3ca772a956d",
            "video_url": ""
        }
    ],
    "id": "669121dd-22a3-41d7-a1f9-d939e6623b91",
    "status": "complete"
}