音频分离回调
callBackUrl 参数设置回调URL。任务完成时，系统将自动向您指定的地址推送结果。回调机制概述
回调时机
回调方式
回调请求格式
callBackUrl 发送POST请求。不同的分离类型对应不同的回调数据结构：separate_vocal 类型回调
成功回调 - separate_vocal
失败回调 - separate_vocal
{
"code": 200,
"msg": "success",
"data": {
"taskId": "8428871e6b58a3abb71996182000b95d",
"model": "suno/separate-vocals",
"state": "success",
"param": "{\"model\":\"suno/separate-vocals\",\"input\":\"{\\\"taskId\\\":\\\"4eb77e3dc8b512e4da4c4874911cfc7a\\\",\\\"audioId\\\":\\\"5c834fd5-4c9e-4196-9840-d05e048d481a\\\",\\\"type\\\":\\\"separate_vocal\\\"}\",\"callBackUrl\":\"http://localhost:8305/test\"}",
"resultJson": "{\"origin_url\":\"\",\"vocal_url\":\"https://tempfile.aiquickdraw.com/r/7002bb81-5af7-460c-bfeb-c0f98cff9edc_Vocals.mp3\",\"instrumental_url\":\"https://tempfile.aiquickdraw.com/r/b4863fea-784e-46bb-860a-d6052fb554e7_Instrumental.mp3\",\"origin_data\":[{\"duration\":265.76,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/7002bb81-5af7-460c-bfeb-c0f98cff9edc_Vocals.mp3\",\"stem_type_group_name\":\"Vocals\",\"id\":\"7002bb81-5af7-460c-bfeb-c0f98cff9edc\"},{\"duration\":265.76,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/b4863fea-784e-46bb-860a-d6052fb554e7_Instrumental.mp3\",\"stem_type_group_name\":\"Instrumental\",\"id\":\"b4863fea-784e-46bb-860a-d6052fb554e7\"}]}",
"failCode": "",
"failMsg": "",
"costTime": 122,
"completeTime": 1786345661000,
"createTime": 1786345527000,
"progress": 100,
"creditsConsumed": 10.0
}
}split_stem 类型回调
成功回调 - split_stem
失败回调 - split_stem
{
"code": 200,
"msg": "success",
"data": {
"taskId": "b5aabc187cefb70664b41973219e1b0d",
"model": "suno/separate-vocals",
"state": "success",
"param": "{\"model\":\"suno/separate-vocals\",\"input\":\"{\\\"taskId\\\":\\\"4eb77e3dc8b512e4da4c4874911cfc7a\\\",\\\"audioId\\\":\\\"5c834fd5-4c9e-4196-9840-d05e048d481a\\\",\\\"type\\\":\\\"split_stem\\\"}\",\"callBackUrl\":\"http://localhost:8305/test\"}",
"resultJson": "{\"origin_url\":\"\",\"vocal_url\":\"https://tempfile.aiquickdraw.com/r/165f14e9-e8b1-4fc9-ac3a-003a7e36ba36_Vocals.mp3\",\"backing_vocals_url\":\"https://tempfile.aiquickdraw.com/r/a5934399-bc4e-4036-9cdf-39ccf2e9522c_Backing_Vocals.mp3\",\"drums_url\":\"https://tempfile.aiquickdraw.com/r/983e3685-8d88-455d-8854-867ed42b806b_Drums.mp3\",\"bass_url\":\"https://tempfile.aiquickdraw.com/r/f8e48ead-953f-4aa9-8e3d-65ad47a4d634_Bass.mp3\",\"guitar_url\":\"https://tempfile.aiquickdraw.com/r/bc63908e-1e47-4db0-838a-e2f836d9155f_Guitar.mp3\",\"keyboard_url\":\"https://tempfile.aiquickdraw.com/r/474ed752-4192-4039-a2a8-9ff2d695e9a5_Keyboard.mp3\",\"percussion_url\":\"https://tempfile.aiquickdraw.com/r/3e4c8afc-939d-487e-9471-a893f1c992c9_Percussion.mp3\",\"strings_url\":\"https://tempfile.aiquickdraw.com/r/efdacf5b-c566-4ab3-8846-4b9a8990e83b_Strings.mp3\",\"synth_url\":\"https://tempfile.aiquickdraw.com/r/cf82ed8b-7a3c-4d40-8e98-48d39b531d17_Synth.mp3\",\"fx_url\":\"https://tempfile.aiquickdraw.com/r/15e62f40-b450-4db4-a1c4-8938b1f88a8d_FX.mp3\",\"brass_url\":\"https://tempfile.aiquickdraw.com/r/4bd7271a-ebf5-4694-8d83-315b1007dbf0_Brass.mp3\",\"woodwinds_url\":\"https://tempfile.aiquickdraw.com/r/76d4e479-f106-486a-b070-b597552c31f6_Woodwinds.mp3\",\"origin_data\":[{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/165f14e9-e8b1-4fc9-ac3a-003a7e36ba36_Vocals.mp3\",\"stem_type_group_name\":\"Vocals\",\"id\":\"165f14e9-e8b1-4fc9-ac3a-003a7e36ba36\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/a5934399-bc4e-4036-9cdf-39ccf2e9522c_Backing_Vocals.mp3\",\"stem_type_group_name\":\"Backing_Vocals\",\"id\":\"a5934399-bc4e-4036-9cdf-39ccf2e9522c\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/983e3685-8d88-455d-8854-867ed42b806b_Drums.mp3\",\"stem_type_group_name\":\"Drums\",\"id\":\"983e3685-8d88-455d-8854-867ed42b806b\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/f8e48ead-953f-4aa9-8e3d-65ad47a4d634_Bass.mp3\",\"stem_type_group_name\":\"Bass\",\"id\":\"f8e48ead-953f-4aa9-8e3d-65ad47a4d634\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/bc63908e-1e47-4db0-838a-e2f836d9155f_Guitar.mp3\",\"stem_type_group_name\":\"Guitar\",\"id\":\"bc63908e-1e47-4db0-838a-e2f836d9155f\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/474ed752-4192-4039-a2a8-9ff2d695e9a5_Keyboard.mp3\",\"stem_type_group_name\":\"Keyboard\",\"id\":\"474ed752-4192-4039-a2a8-9ff2d695e9a5\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/3e4c8afc-939d-487e-9471-a893f1c992c9_Percussion.mp3\",\"stem_type_group_name\":\"Percussion\",\"id\":\"3e4c8afc-939d-487e-9471-a893f1c992c9\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/efdacf5b-c566-4ab3-8846-4b9a8990e83b_Strings.mp3\",\"stem_type_group_name\":\"Strings\",\"id\":\"efdacf5b-c566-4ab3-8846-4b9a8990e83b\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/cf82ed8b-7a3c-4d40-8e98-48d39b531d17_Synth.mp3\",\"stem_type_group_name\":\"Synth\",\"id\":\"cf82ed8b-7a3c-4d40-8e98-48d39b531d17\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/15e62f40-b450-4db4-a1c4-8938b1f88a8d_FX.mp3\",\"stem_type_group_name\":\"FX\",\"id\":\"15e62f40-b450-4db4-a1c4-8938b1f88a8d\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/4bd7271a-ebf5-4694-8d83-315b1007dbf0_Brass.mp3\",\"stem_type_group_name\":\"Brass\",\"id\":\"4bd7271a-ebf5-4694-8d83-315b1007dbf0\"},{\"duration\":266.0,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/76d4e479-f106-486a-b070-b597552c31f6_Woodwinds.mp3\",\"stem_type_group_name\":\"Woodwinds\",\"id\":\"76d4e479-f106-486a-b070-b597552c31f6\"}]}",
"failCode": "",
"failMsg": "",
"costTime": 163,
"completeTime": 1786346978000,
"createTime": 1786346785000,
"progress": 100,
"creditsConsumed": 50.0
}
} split_stem_advanced 类型回调
成功回调 - split_stem_advanced
失败回调 - split_stem_advanced
{
"code": 200,
"msg": "success",
"data": {
"taskId": "b749f09aafb6a53656098d3e1e9c54dc",
"model": "suno/separate-vocals",
"state": "success",
"param": "{\"model\":\"suno/separate-vocals\",\"input\":\"{\\\"taskId\\\":\\\"4eb77e3dc8b512e4da4c4874911cfc7a\\\",\\\"audioId\\\":\\\"5c834fd5-4c9e-4196-9840-d05e048d481a\\\",\\\"type\\\":\\\"split_stem_advanced\\\",\\\"stemName\\\":\\\"Lead Vocal\\\"}\",\"callBackUrl\":\"http://localhost:8305/test\"}",
"resultJson": "{\"origin_url\":\"\",\"origin_data\":[{\"extract\":{\"duration\":265.8,\"success\":true,\"stem_task\":\"extract\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/2e6a0f01-b0cc-4874-9032-da9a0c29371c_Lead Vocal.mp3\",\"stem_type_group_name\":\"Lead Vocal\",\"id\":\"2e6a0f01-b0cc-4874-9032-da9a0c29371c\"},\"remove\":{\"duration\":265.8,\"success\":true,\"stem_task\":\"remove\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/d8fa7711-b43c-4735-a474-8cf2b0c1553d_Lead Vocal.mp3\",\"stem_type_group_name\":\"Lead Vocal\",\"id\":\"d8fa7711-b43c-4735-a474-8cf2b0c1553d\"}},{\"extract\":{\"duration\":265.8,\"success\":true,\"stem_task\":\"extract\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/d26c5745-40f3-4426-9c56-17b79f5c8cd4_Lead Vocal.mp3\",\"stem_type_group_name\":\"Lead Vocal\",\"id\":\"d26c5745-40f3-4426-9c56-17b79f5c8cd4\"},\"remove\":{\"duration\":265.8,\"success\":true,\"stem_task\":\"remove\",\"audio_url\":\"https://tempfile.aiquickdraw.com/r/34c14e2d-012d-4da1-b047-15c2b7b6152a_Lead Vocal.mp3\",\"stem_type_group_name\":\"Lead Vocal\",\"id\":\"34c14e2d-012d-4da1-b047-15c2b7b6152a\"}}]}",
"failCode": "",
"failMsg": "",
"costTime": 111,
"completeTime": 1786347541000,
"createTime": 1786347417000,
"progress": 100,
"creditsConsumed": 20.0
}
}状态码说明
code (integer, required)
| 状态码 | 描述 |
|---|---|
| 200 | 成功 - 请求已成功处理 |
| 400 | 验证错误 - 歌词包含受版权保护的内容 |
| 408 | 超出限制 - 超时 |
| 413 | 冲突 - 上传的音频与现有艺术作品匹配 |
| 500 | 服务器错误 - 处理请求时发生意外错误 |
| 501 | 音频生成失败 |
| 531 | 服务器错误 - 抱歉，由于问题生成失败。您的积分已退还。请重试 |
msg (string, required)
data.task_id (string, required)
data.vocal_removal_info (object)
separate_vocal 类型回调字段
data.vocal_removal_info.instrumental_url (string)
data.vocal_removal_info.origin_url (string)
data.vocal_removal_info.vocal_url (string)
split_stem 类型回调字段
data.vocal_removal_info.origin_url (string)
data.vocal_removal_info.vocal_url (string)
data.vocal_removal_info.backing_vocals_url (string)
data.vocal_removal_info.drums_url (string)
data.vocal_removal_info.bass_url (string)
data.vocal_removal_info.guitar_url (string)
data.vocal_removal_info.keyboard_url (string)
data.vocal_removal_info.percussion_url (string)
data.vocal_removal_info.strings_url (string)
data.vocal_removal_info.synth_url (string)
data.vocal_removal_info.fx_url (string)
data.vocal_removal_info.brass_url (string)
data.vocal_removal_info.woodwinds_url (string)
split_stem_advanced 类型回调字段
data.vocal_removal_info.origin_data (array)
data.vocal_removal_info.origin_data[].extract (object)
data.vocal_removal_info.origin_data[].extract.duration (number)
data.vocal_removal_info.origin_data[].extract.audio_url (string)
data.vocal_removal_info.origin_data[].extract.stem_type_group_name (string)
data.vocal_removal_info.origin_data[].extract.id (string)
data.vocal_removal_info.origin_data[].remove (object)
data.vocal_removal_info.origin_data[].remove.duration (number)
data.vocal_removal_info.origin_data[].remove.audio_url (string)
data.vocal_removal_info.origin_data[].remove.stem_type_group_name (string)
data.vocal_removal_info.origin_data[].remove.id (string)
回调接收示例
Node.js
最佳实践
回调URL配置建议
1.
2.
3.
4.
5.
6.
7.