POST https://api.deerapi.com/suno/submit/music
GET https://api.deerapi.com/suno/fetch/{task_id}
{
"gpt_description_prompt": "乡愁"
}
{
"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[Bridge]\n老板的脚步声像雷鸣\n心跳随着节奏加速\n桌上的文件一大堆\n抱怨的声音渐渐消失\n\n[Chorus]\n工作工作老板的呼喊\n做完做完这才算平安\n加班加班才有些钱赚\n梦想梦想何时能实现",
"mv": "chirp-auk",
"title": "工作",
"tags": " edm"
}
{
"prompt": "",
"tags": "heavy metal",
"mv": "chirp-auk",
"title": "北京",
"continue_clip_id": null,
"continue_at": null,
"infill_start_s": null,
"infill_end_s": null
}
{
"gpt_description_prompt": "一首关于彻夜跳舞的国歌舞蹈流行歌曲",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true
}
clip_id
值{
"prompt": "歌词",
"tags": "",
"negative_tags": "",
"mv": "chirp-v4",
"title": "标题",
"continue_clip_id": "ca94a97d-d3f2-4a63-aeee-ba3a43384bcd",
"continue_at": 10,
"task": "upload_extend"
}
注意: 这里的 mv 是 chirp-auk-upload
或者chirp-v4-upload
{
"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[Bridge]\n老板的脚步声像雷鸣\n心跳随着节奏加速\n桌上的文件一大堆\n抱怨的声音渐渐消失\n\n[Chorus]\n工作工作老板的呼喊\n做完做完这才算平安\n加班加班才有些钱赚\n梦想梦想何时能实现",
"tags": "heavy metal",
"mv": "chirp-auk-upload",
"title": "工作",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30.792
}
注意: is_infill
为false
扣费: 一首歌的费用
POST https://api.deerapi.com/suno/submit/music/concat
注意: 续写官方产生的音乐,自定义不可用
clip_id
值clip_id
,取其中一个{
"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[Bridge]\n老板的脚步声像雷鸣\n心跳随着节奏加速\n桌上的文件一大堆\n抱怨的声音渐渐消失\n\n[Chorus]\n工作工作老板的呼喊\n做完做完这才算平安\n加班加班才有些钱赚\n梦想梦想何时能实现",
"tags": "heavy metal",
"mv": "chirp-auk",
"title": "工作",
"continue_clip_id": "abcd-1234-1234-1234-abd",
"continue_at": 30,
"task": "extend"
}
注意: is_infill
为false
扣费: 0.1
POST https://api.deerapi.com/suno/submit/music/concat
clip_id
值clip_id
,这样就可以 cover 自定义音频注意: mv 为 chirp-v4
或者chirp-bluejay
或者chirp-auk
task 为 cover
可跨账号使用,不用担心账号下线 cover_clip_id
如果是 upload 的clip_id
为不可跨账号mv 不在使用 chirp-v3-5-tau,chirp-v4-tau
{
"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[Bridge]\n老板的脚步声像雷鸣\n心跳随着节奏加速\n桌上的文件一大堆\n抱怨的声音渐渐消失\n\n[Chorus]\n工作工作老板的呼喊\n做完做完这才算平安\n加班加班才有些钱赚\n梦想梦想何时能实现",
"generation_type": "TEXT",
"tags": "rock, punk",
"negative_tags": "",
"mv": "chirp-auk",
"title": "工作 (Cover)",
"continue_clip_id": null,
"continue_at": null,
"continued_aligned_prompt": null,
"infill_start_s": null,
"infill_end_s": null,
"task": "cover",
"task_id": "77d7ac95-1b73-4947-9387-e6b635a1a8d1",
"cover_clip_id": "abcd-1234-1234-1234-abd"
}
clip_id
值注意: task 为 infill
mv 为 chirp-v3-5-tau
或者chirp-v4-tau
或者chirp-auk
替换的歌词要跟原来的歌词有重复的地方,最好相应的时间能对应上 infill_start_s
开始时间,infill_end_s
结束时间,infill_dur_s
为infill_end_s-infill_start_s
可跨账号使用,不用担心账号下线 会得到 2 个新的 clip_id
,选择其中一个 给下一步使用
{
"task": "infill",
"generation_type": "TEXT",
"title": "思念的刻度-replace",
"tags": "Sorrow/Sad,Female Vocals,Mandarin",
"mv": "chirp-auk",
"prompt": "《思念的刻度》 \n \n作词:阿果依珞\n年轮里刻着你奔跑的温度。 \n每片落叶都在替你呼唤\n可风一吹就碎成雾。 \n整理角落你的吉他 \n琴箱里积攒所有雨季, \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦, \n怕一碰就碎成 \n当年的回音。 \n时光是倒流的录像带, \n夜越深你笑声越清晰传来。 \n如果眼泪能浇灌时光隧道, \n我愿把眼睛哭成海。 \n当所有春天都与你有关, \n我学会用伤口呼吸。 \n继续爱你, \n用尽",
"metadata": {
"infill_lyrics": "。 \n整理角落你的吉他 \n琴箱里积攒所有雨季, \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦, \n怕一碰就碎成 \n当年的回音"
},
"continue_clip_id": "8a858961-8831-4423-8ffb-2dec096aea0a",
"continued_aligned_prompt": "《思念的刻度》 \n \n作词:阿果依珞\n年轮里刻着你奔跑的温度。 \n每片落叶都在替你呼唤\n可风一吹就碎成雾。 \n整理角落你的吉他 \n琴箱里积攒所有雨季, \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦, \n怕一碰就碎成 \n当年的回音。 \n时光是倒流的录像带, \n夜越深你笑声越清晰传来。 \n如果眼泪能浇灌时光隧道, \n我愿把眼睛哭成海。 \n当所有春天都与你有关, \n我学会用伤口呼吸。 \n继续爱你, \n用尽所有 \n不再跳动的心跳。\n整理角落你的吉他 \n琴箱里积攒所有雨季, \n潮湿了玫瑰木的背脊。 \n若把思念缠成新弦, \n怕一碰就碎成 \n当年的回音。 \n当所有春天都与你有关, \n我学会用伤口呼吸。 \n继续爱你, \n用尽所有 \n不再跳动的心跳。\n",
"infill_context_start_s": 3.48,
"infill_context_end_s": 109.96,
"infill_start_s": 33.48,
"infill_end_s": 79.96,
"infill_dur_s": 46.48
}
注意: is_infill
为true
扣费: 0.1
POST https://api.deerapi.com/suno/submit/music/concat
task id
task id
后,根据需要获取歌曲的对应 clip_id
值注意:
将对应的clip_id
入参, 填入该接口 ,得到返回的id为persona_id供下一步使用clip_id
需要系统内存在的,非 uploader不能跨账号,所以可能账号下线用不了 为防止滥用会扣 0.1
POST https://api.deerapi.com/suno/persona/create
{
"root_clip_id": "54834687-5e79-4f08-8e14-cf188f15b598",
"name": "Persona 标题",
"description": "Persona 描述",
"clips": ["54834687-5e79-4f08-8e14-cf188f15b598"],
"is_public": true
}
使用接口: 新建persona
注意事项:**mv 为 chirp-v3-5-tau
或者chirp-v4-tau
或者chirp-auk
task 为 artist_consistency
persona_id
为 新建persona 接口 步骤得到的返回idartist_clip_id 就是 生成音乐 步骤中的 clip_id 可跨账号
POST https://api.deerapi.com/suno/submit/music
{
"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"
}
clip_id
值注意: mv 为 chirp-auk
task 为 gen_stem
stem_task
为twelve
stem_type_group_name
为Twelve
continue_clip_id
就是 A 步骤中的clip_id
可跨账号 计费: 5 倍基础价格,5 次 10 首歌的价格
POST https://api.deerapi.com/suno/submit/music
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "安全之弦",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true,
"continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve"
}
clip_id
,使用task id 查询GET https://api.deerapi.com/suno/fetch/{task_id}
clip_id
值注意: mv 为 chirp-auk
task 为 gen_stem
stem_task
为two
stem_type_group_name
为Two
continue_clip_id
就是 A 步骤中的clip_id
可跨账号 计费: 五次生成费用
POST https://api.deerapi.com/suno/submit/music
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "安全之弦",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true,
"continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Two",
"stem_task": "two"
}
GET https://api.deerapi.com/suno/fetch/{task_id}
task_id
和 clip_id
。
clip_id
进行声曲分离。返回的 task_id
用于查询分离结果。注意: mv
参数为chirp-auk
。task
参数为gen_stem
。continue_clip_id
填入 A 步骤中上传音乐文件后返回的clip_id
。stem_task
和stem_type_group_name
决定分离类型。示例为全轨分离。可跨账号使用。 计费: 费用与 All-Stems
(场景 10) 或Stems
(场景 11) 相同。
{
"task": "gen_stem",
"generation_type": "TEXT",
"title": "上传音频声曲分离",
"mv": "chirp-auk",
"prompt": "",
"make_instrumental": true,
"continue_clip_id": "eeb77e7a-e2a5-4fb0-96b5-d6a27d5ab09c", // 替换为上传后获取的clip_id
"continued_aligned_prompt": null,
"continue_at": null,
"stem_type_id": 91,
"stem_type_group_name": "Twelve",
"stem_task": "twelve"
}
task_id
查询声曲分离结果。GET https://api.deerapi.com/suno/fetch/{task_id}
clip_id
值注意: 可跨账号
GET https://api.deerapi.com/suno/act/timing/{clip_id}
clip_id
值为 a624123d-22cc-4d4d-bf28-78d312f61597
注意: 如果返回体 wav_file_url
为 null,多获取几次为防止滥用会扣除 0.1 不可跨账号,账号下线后不可调用
GET https://api.deerapi.com/suno/act/wav/{clip_id}
clip_id
值注意: 需要状态是 complete
执行才有效果执行完需要等待 30 秒后 URL 才能访问 为防止滥用会扣除 0.1 不可跨账号,账号下线后不可调用
GET https://api.deerapi.com/suno/act/mp4/{clip_id}
weirdness_constraint
,style_weight
, audio_weight
参数weirdness_constraint
style_weight
audio_weight
(仅在 cover 的时候出现)POST https://api.deerapi.com/suno/submit/music
{
"prompt": "[Verse]\nI got a plate of dreams piled high\nA world of flavors I wanna try\nSpices dancing under the sky\nTaste buds soaring I won't deny\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I'm feeling bold\nLife's a buffet can't be controlled\n\n[Verse 2]\nFrom tacos wrapped so tight with love\nTo noodles swimming skies above\nPizza slices like a dove\nFlying straight to my tastebud glove\n\n[Bridge]\nOh the crunch of chips so loud\nPopcorn popping in a cloud\nChocolate melting makes me proud\nIn this feast I'm unbowed\n\n[Chorus]\nCrunch and sizzle sweet and sour\nEvery bite holds a little power\nBite by bite I'm feeling bold\nLife's a buffet can't be controlled\n\n[Verse 3]\nSaucy rivers on a plate\nFlavors whispering don't be late\nEvery meal's a twist of fate\nI'll devour till it's too great",
"generation_type": "TEXT",
"tags": "house, tight drums",
"negative_tags": "现代",
"mv": "chirp-auk",
"title": "Savor the Flavor",
"metadata": {
"create_mode": "custom",
"control_sliders": {
"style_weight": 0.4,
"weirdness_constraint": 0.7
},
"can_control_sliders": ["weirdness_constraint", "style_weight"]
}
}
audio_weight
参数POST https://api.deerapi.com/suno/submit/music
{
"prompt": "[Verse]\n新年钟声敲响\n烟花照亮夜晚\n笑声传遍四方\n好运陪伴身旁\n\n[Chorus]\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心愿成真福满堂",
"generation_type": "TEXT",
"tags": "",
"negative_tags": "",
"mv": "chirp-auk",
"title": "新年快乐 (Remix)",
"task": "cover",
"cover_clip_id": "f31754fc-2c83-4fc1-8a07-70ae218dd0a6",
"metadata": {
"create_mode": "custom",
"control_sliders": {
"style_weight": 0.68,
"audio_weight": 0.48,
"weirdness_constraint": 0.37
},
"can_control_sliders": [
"weirdness_constraint",
"style_weight",
"audio_weight"
],
"is_remix": true
}
}
注意: task 为 underpainting
underpainting_clip_id
为上传的clip_id
underpainting_end_s
必须小于等于上传的 duration计费 一次歌曲费用 不允许跨账号
clip_id
。POST https://api.deerapi.com/suno/uploads/audio-url
clip_id
查询时长。GET https://api.deerapi.com/suno/fetch/{task_id}
metadata.duration
时长。POST https://api.deerapi.com/suno/submit/music
{
"mv": "chirp-bluejay",
"tags": "Pop rap, uplifting, magnetic male vocals, piano, synth, electric guitar, driving bass, clear structure",
"title": "Hi Insterumental",
"underpainting_clip_id": "3c332c7c-85e5-4d36-9949-9af0521af891",
"underpainting_start_s": 0,
"underpainting_end_s": 37.9,
"task": "underpainting",
"prompt": "",
"override_fields": ["prompt", "tags"]
}
注意: task 为 overpainting
overpainting_clip_id
为上传的clip_id
overpainting_end_s
必须小于等于上传的metadata.duration
tags 为上传的 metadata.tags
计费 一次歌曲费用 不允许跨账号
clip_id
。POST https://api.deerapi.com/suno/uploads/audio-url
clip_id
查询时长和tags。GET https://api.deerapi.com/suno/fetch/{task_id}
metadata.duration
时长,同时获取 metadata.tags
。POST https://api.deerapi.com/suno/submit/music
{
"mv": "chirp-bluejay",
"tags": "A smooth, soulful R&B track with a moderate tempo and a relaxed, laid-back feel. The instrumentation features a clean electric guitar playing arpeggiated chords, a prominent bass guitar providing a walking bass line, and a drum kit with a soft, brushed snare sound. The male lead vocal is smooth and melodic, with a baritone range and a slightly melancholic tone. The song is in a minor key, contributing to its introspective mood. Production elements include a subtle reverb on the vocals and guitar, creating a spacious and intimate atmosphere. The song structure follows a typical verse-chorus format with a clear melodic progression.",
"title": "Hi vocal",
"overpainting_clip_id": "3c332c7c-85e5-4d36-9949-9af0521af891",
"overpainting_start_s": 0,
"overpainting_end_s": 37.9,
"task": "overpainting",
"prompt": "yourself ",
"override_fields": ["prompt", "tags"]
}