POST https://api.deerapi.com/suno/submit/musicGET 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",
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"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",
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"continue_at": 30,
"task": "extend"
}注意: is_infill为false
扣费: 0.1
POST https://api.deerapi.com/suno/submit/music/concatclip_id 值clip_id,这样就可以 cover 自定义音频注意: mv 为 chirp-v4或者chirp-bluejay或者chirp-auktask 为 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-v4-tau",
"title": "Work (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 为 infillmv 为 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",
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"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/concattask idtask 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-v4或者chirp-bluejay或者chirp-auktask 为 artist_consistencypersona_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-auk",
"title": "老公",
"task": "artist_consistency",
"persona_id": "0f6e8077-a7ba-4fc8-8f60-de02c66e56ce",
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"artist_clip_id": "a5fa604c-18b8-4e7f-8d25-9412d4ba8163"
}clip_id 值注意: mv 为 chirp-auktask 为 gen_stemstem_task为twelvestem_type_group_name为Twelvecontinue_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",
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"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-auktask 为 gen_stemstem_task为twostem_type_group_name为Twocontinue_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",
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"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
"task_id": "d2dc63d1-70b8-46ea-85b1-8d71fe59466f",
"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_constraintstyle_weightaudio_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"],
"vocalgender":"m"
}
}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 为 underpaintingunderpainting_clip_id为上传的clip_idunderpainting_end_s必须小于等于上传的 duration计费 一次歌曲费用 不允许跨账号
clip_id。POST https://api.deerapi.com/suno/uploads/audio-urlclip_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 为 overpaintingoverpainting_clip_id为上传的clip_idoverpainting_end_s必须小于等于上传的metadata.durationtags 为上传的 metadata.tags计费 一次歌曲费用 不允许跨账号
clip_id。POST https://api.deerapi.com/suno/uploads/audio-urlclip_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"]
}clip_id 值。注意: 普通音乐的 clip_id也能执行,但官网只有全轨分离的clip_id才有 MIDI 功能扣费: 0.01 不可跨账号,账号下线后不可调用
clip_id: a624123d-22cc-4d4d-bf28-78d312f61597GET https://api.deerapi.com/suno/act/midi/{clip_id}{
"state": "running"
}{
"state": "complete",
"instruments": [
{
"name": "String Ensembles 1",
"notes": [
{
"pitch": 60,
"start": 1.1041666666666667,
"end": 1.9583333333333333,
"velocity": 0.7165354330708661
},
...
]
},
...
]
}state: 状态,running 表示处理中,complete 表示完成instruments: 乐器数组name: 乐器名称notes: 音符数组pitch: 音高(MIDI 音符编号,60 = 中央C)start: 开始时间(秒)end: 结束时间(秒)velocity: 力度(0-1之间)POST https://api.deerapi.com/suno/act/tags{
"upsampled_tags": "Laid-back indie pop driven by a clean guitar riff, tight bass, and crisp drums. Verses feature subtle synth textures and gentle background vocals. A catchy chorus lifts with layered harmonies and handclaps. Bridge introduces a bright Rhodes piano before a dynamic final chorus.",
"request_id": "507acd16-8b84-4e55-be2b-4329d82efb26"
}