Skip to content
EN

生成歌曲(歌手风格)

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

接入步骤:

A.生成音乐

可以通过场生成歌曲接口生成后,获取其中的一首歌的 clip_id 值为 54834687-5e79-4f08-8e14-cf188f15b598

B.新建 Persona

clip_id 需要系统内存在的,非 uploader 不能跨账号 所以可能账号下线用不了

C.使用 persona_id 创作

注意 mv 为 chirp-v3-5-tau 或者 chirp-v4-tau task 为 artist_consistency persona_id 为 B 步骤得到的 artist_clip_id 就是 A 步骤中的 clip_id 可跨账号

请求参数

Header 参数

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

Body 参数 application/json

text
prompt
string
必需
generation_type
string
必需
tags
string
必需
negative_tags
string
必需
mv
string
必需
title
string
必需
task
string
必需
persona_id
string
必需
artist_clip_id
string
必需
示例
{
"prompt"
:
"[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌"
,
"generation_type"
:
"TEXT"
,
"tags"
:
"electronic, pop"
,
"negative_tags"
:
""
,
"mv"
:
"chirp-v4-tau"
,
"title"
:
"老公"
,
"task"
:
"artist_consistency"
,
"persona_id"
:
"0f6e8077-a7ba-4fc8-8f60-de02c66e56ce"
,
"artist_clip_id"
:
"a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}

请求示例代码

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": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
  "generation_type": "TEXT",
  "tags": "electronic, pop",
  "negative_tags": "",
  "mv": "chirp-v4-tau",
  "title": "老公",
  "task": "artist_consistency",
  "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
  "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

text
object

示例

json
{
    "id": "2d453a5f-c539-4fe0-9a66-24058c5dfb6a",
    "clips": [
        {
            "id": "0e6937df-64d8-41f9-82c6-b6dadc4426a8",
            "video_url": "",
            "audio_url": "",
            "major_model_version": "v4",
            "model_name": "chirp-v4",
            "metadata": {
                "tags": "electronic, pop",
                "prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
                "type": "gen",
                "stream": true,
                "has_vocal": false,
                "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
                "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
                "task": "artist_consistency"
            },
            "is_liked": false,
            "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
            "display_name": "TwinklingVenue1595",
            "handle": "twinklingvenue1595",
            "is_handle_updated": false,
            "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
            "is_trashed": false,
            "created_at": "2024-12-23T10:37:43.596Z",
            "status": "submitted",
            "title": "老公",
            "play_count": 0,
            "upvote_count": 0,
            "is_public": false
        },
        {
            "id": "fff58de4-7ccc-4b95-937b-3b66ec07cc65",
            "video_url": "",
            "audio_url": "",
            "major_model_version": "v4",
            "model_name": "chirp-v4",
            "metadata": {
                "tags": "electronic, pop",
                "prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
                "type": "gen",
                "stream": true,
                "has_vocal": false,
                "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
                "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
                "task": "artist_consistency"
            },
            "is_liked": false,
            "user_id": "a3da04d5-0442-4bd3-b837-4c73ff600914",
            "display_name": "TwinklingVenue1595",
            "handle": "twinklingvenue1595",
            "is_handle_updated": false,
            "avatar_image_url": "https://cdn1.suno.ai/defaultPink.webp",
            "is_trashed": false,
            "created_at": "2024-12-23T10:37:43.596Z",
            "status": "submitted",
            "title": "老公",
            "play_count": 0,
            "upvote_count": 0,
            "is_public": false
        }
    ],
    "metadata": {
        "tags": "electronic, pop",
        "prompt": "[Verse]\n你从清晨到黄昏\n一直在我身边温暖\n风吹雨打也不怕\n紧握手永不分开\n\n[Verse 2]\n有你在我不孤单\n就像繁星在夜晚\n路再长也不觉得远\n因为你是我的光\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Verse 3]\n你是我的避风港\n每天夜里梦都是你\n即使前路多辛苦\n有你一切多美丽\n\n[Chorus]\n老公老公我爱你\n你是世界的唯一\n无论在天涯海角\n心如影随形不离\n\n[Bridge]\n生命中的每一刻\n有你陪伴去体会\n所有明天都更好\n因为有你我无敌",
        "type": "gen",
        "stream": true,
        "has_vocal": false,
        "artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163",
        "persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
        "task": "artist_consistency"
    },
    "major_model_version": "v4",
    "status": "complete",
    "created_at": "2024-12-23T10:37:43.581Z",
    "batch_size": 1
}