KIE.AI
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
Market
File Upload APICommon API
Market
File Upload APICommon API
  1. Vocal Removal
  • 开始使用
  • Market
  • Image Models
    • Seedream
      • Seedream3.0 生成图像
      • Seedream4.0 文生图
      • Seedream4.0 图片编辑
      • Seedream4.5 文生图
      • Seedream4.5 图片编辑
      • Seedream5.0 Lite 文生图
      • Seedream5.0 Lite 图片编辑
    • Z-image
      • 使用 z-image 生成内容
    • Google
      • 使用 nano-banana-2 生成内容
      • Google Imagen4 Fast
      • Google Imagen4 Ultra
      • Google Imagen4
      • Nano Banana 图片编辑
      • Google Nano Banana
      • Nano Banana Pro 图生图
    • Flux-2
      • Flux-2 Pro 图生图
      • Flux-2 Pro 文生图
      • Flux-2 图生图
      • Flux-2 文生图
    • Grok Imagine
      • Grok Imagine 文生图
      • Grok Imagine 图生图
    • GPT Image
      • GPT Image1.5 文生图
      • GPT Image1.5 图生图
    • Topaz
      • Topaz 图像优化
    • Recraft
      • Recraft 背景移除
      • Recraft 图像优化
    • Ideogram
      • Ideogram V3 图片重构
      • Ideogram 角色编辑
      • Ideogram 角色重混
      • Ideogram 角色图像生成
      • Ideogram V3 文生图
      • Ideogram V3 图像编辑
      • Ideogram V3 混合
    • Qwen
      • Qwen 文生图
      • Qwen 图生图
      • Qwen 图片编辑
      • Qwen2 图片编辑
      • Qwen2 文生图
    • 4o Image API
      • 4o Image API 快速开始
      • 4o 图片生成回调
      • 生成4o图像
      • 获取4o图像详情
      • 获取直接下载URL
    • Flux Kontext API
      • Flux Kontext API 快速开始
      • 图像生成或编辑回调
      • 生成或编辑图像
      • 获取图像详情
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
  • Video Models
    • Grok Imagine
      • Grok Imagine 文生视频
      • Grok Imagine 图生视频
      • 放大 Grok Imagine 视频
      • 扩展 Grok Imagine 视频
    • Kling
      • Kling-2.6 文生视频
      • Kling-2.6 图生视频
      • Kling V2.5 Turbo Pro 图生视频
      • Kling V2.5 Turbo Pro 文生视频
      • Kling AI Avatar Standard
      • Kling AI Avatar Pro
      • Kling V2.1 Master 图生视频
      • Kling V2.1 Master 文生视频
      • Kling V2.1 Pro
      • Kling V2.1 Standard
      • kling-2.6 motion-control
      • kling-3.0 motion-control
      • Kling 3.0
    • Bytedance
      • Bytedance Seedance 2.0
      • Bytedance Seedance 2.0 Fast
      • 创建火山资产
      • 查询火山引擎资产状态
      • Bytedance Seedance 1.5 Pro
      • Bytedance V1 Pro Fast 图生视频
      • Bytedance V1 Pro 图生视频
      • Bytedance V1 Pro 文生视频
      • Bytedance V1 Lite 图生视频
      • Bytedance V1 Lite 文生视频
    • Hailuo
      • Hailuo 2.3 Pro 图生视频
      • Hailuo 2.3 Standard 图生视频
      • Hailuo Pro 文生视频
      • Hailuo Pro 图生视频
      • Hailuo Standard 文生视频
      • Hailuo Standard 图生视频
    • Sora2
      • Sora2 图生视频
      • Sora2 文生视频
      • Sora2 Pro 图生视频
      • Sora2 Pro 文生视频
      • Sora2 水印移除
      • Sora-2 Pro Storyboard
      • Sora2 - Characters
      • Sora2 - Characters Pro
    • Wan
      • Wan 2.6 - 图转视频
      • Wan 2.6 - 文转视频
      • Wan 2.6 - 视频转视频
      • Wan 2.2 A14B Turbo 图生视频
      • Wan 2.2 A14B Turbo 文生视频
      • Wan 2.2 A14B Turbo 语音转视频
      • Wan 动画移动
      • Wan 动画替换
      • Wan - Flash 图转视频
      • Wan - Flash 视频转视频
      • Wan 2.5 - 图转视频
      • Wan 2.5 - 文转视频
      • Wan 2.7 - 文转视频
      • Wan 2.7 - 图转视频
      • Wan 2.7 - 视频编辑
      • Wan 2.7 - 参考生视频
    • Topaz
      • Topaz视频优化
    • Infinitalk
      • Infinitalk视频生成
    • Runway API
      • Runway API 快速开始
      • AI 视频生成回调
      • AI 视频扩展回调
      • Aleph
        • Aleph 视频生成回调
        • 生成 Aleph 视频
        • 获取 Aleph 视频详情
      • 生成AI视频
      • 获取AI视频详情
      • 延长AI视频
  • Music Models
    • ElevenLabs
      • ElevenLabs对话文生语音V3
      • ElevenLabs Turbo 2.5文生语音
      • ElevenLabs文生语音 多语言V2
      • ElevenLabs语音转文字
      • ElevenLabs音效V2
      • ElevenLabs音频分离
  • Chat Models
    • GPT
      • GPT 5.2
      • GPT 5.4 (response)
    • Claude
      • Claude Haiku 4.5
      • Claude Opus 4.5
      • Claude Opus 4.6
      • Claude Sonnet 4.5
      • Claude Sonnet 4.6
    • Gemini
      • Gemini 2.5 Pro (openai)
      • Gemini 3 Pro (openai)
      • Gemini 3.1 Pro (openai)
      • Gemini 2.5 Flash (openai)
      • Gemini 3 Flash (openai)
      • Gemini 3 Flash
    • Codex
      • GPT Codex
  • Veo3.1 API
    • Veo3.1 API 快速开始
    • Veo3.1 视频生成回调
    • 获取 4K 视频回调
    • 生成veo3.1视频
    • 扩展veo3.1视频
    • 获取1080P视频
    • 获取4K视频
    • 查询veo3.1视频详情
  • Suno API
    • Suno API 快速开始
    • Music Generation
      • 生成音乐回调
      • 音乐扩展回调
      • 音频上传和翻唱回调
      • 音频上传和扩展回调
      • 添加伴奏回调
      • 添加人声回调
      • 音乐封面生成回调
      • 替换音乐分区回调
      • 生成音乐
      • 延长音乐
      • 上传并翻唱音乐
      • 上传并扩展音乐
      • 添加伴奏生成音乐
      • 添加人声生成音乐
      • 获取音乐任务详情
      • 获取带时间戳的歌词
      • 提升音乐风格
      • 生成音乐封面
      • 获取音乐封面生成详情
      • 替换音乐分区
      • 生成 Persona
      • 生成混音音乐
    • Lyrics Generation
      • 生成歌词回调
      • 生成歌词
      • 获取歌词任务详情
    • WAV Conversion
      • 转换为WAV格式回调
      • 转换为WAV格式
      • 获取WAV转换详情
    • Vocal Removal
      • 音频分离回调
      • MIDI 生成回调
      • 人声和乐器分离
        POST
      • 获取人声和乐器分离详情
        GET
      • 从音频生成 MIDI
        POST
      • 获取 MIDI 生成详情
        GET
    • Music Video Generation
      • MP4生成完成回调
      • 创建音乐视频
      • 获取音乐视频详情
    • Sounds Generation
      • 生成声音
  • 获取任务详情
    GET
  1. Vocal Removal

音频分离回调

当人声和乐器分离生成完成时,系统会调用此回调通知结果。
当您向Suno API提交人声分离任务时,可以使用 callBackUrl 参数设置回调URL。任务完成时,系统将自动向您指定的地址推送结果。

回调机制概述#

回调机制消除了轮询API获取任务状态的需要。系统会主动向您的服务器推送任务完成结果。
Webhook 安全性:为确保回调请求的真实性和完整性,我们强烈建议您实现 webhook 签名验证。请参阅我们的 Webhook 校验指南 了解详细实现步骤。

回调时机#

系统将在以下情况发送回调通知:
人声分离任务成功完成
人声分离任务失败
任务处理过程中发生错误

回调方式#

HTTP方法: POST
内容类型: application/json
超时设置: 15秒

回调请求格式#

任务完成时,系统将根据您选择的分离类型向您的 callBackUrl 发送POST请求。不同的分离类型对应不同的回调数据结构:

separate_vocal 类型回调#

成功回调 - separate_vocal
失败回调 - separate_vocal
{
  "code": 200,
  "msg": "vocal Removal generated successfully.",
  "data": {
    "task_id": "3e63b4cc88d52611159371f6af5571e7",
    "vocal_removal_info": {
      "instrumental_url": "https://file.aiquickdraw.com/s/d92a13bf-c6f4-4ade-bb47-f69738435528_Instrumental.mp3",
      "origin_url": "",
      "vocal_url": "https://file.aiquickdraw.com/s/3d7021c9-fa8b-4eda-91d1-3b9297ddb172_Vocals.mp3"
    }
  }
}

split_stem 类型回调#

成功回调 - split_stem
失败回调 - split_stem
{
  "code": 200,
  "msg": "vocal Removal generated successfully.",
  "data": {
    "task_id": "e649edb7abfd759285bd41a47a634b10",
    "vocal_removal_info": {
      "origin_url": "",
      "vocal_url": "https://file.aiquickdraw.com/s/07420749-29a2-4054-9b62-e6a6f8b90ccb_Vocals.mp3",
      "backing_vocals_url": "https://file.aiquickdraw.com/s/aadc51a3-4c88-4c8e-a4c8-e867c539673d_Backing_Vocals.mp3"
      // ... 其他乐器 URL ...
    }
  }
}

状态码说明#

code (integer, required)#

回调状态码,表示任务处理结果:
状态码描述
200成功 - 请求已成功处理
400验证错误 - 歌词包含受版权保护的内容
408超出限制 - 超时
413冲突 - 上传的音频与现有艺术作品匹配
500服务器错误 - 处理请求时发生意外错误
501音频生成失败
531服务器错误 - 抱歉,由于问题生成失败。您的积分已退还。请重试

msg (string, required)#

状态消息,提供更详细的状态描述

data.task_id (string, required)#

任务ID,与您提交任务时返回的task_id一致

data.vocal_removal_info (object)#

人声分离结果信息,成功时返回。返回的字段取决于分离类型(type参数)

separate_vocal 类型回调字段#

data.vocal_removal_info.instrumental_url (string)#

伴奏部分音频URL(separate_vocal类型专有)

data.vocal_removal_info.origin_url (string)#

原始音频URL

data.vocal_removal_info.vocal_url (string)#

人声部分音频URL

split_stem 类型回调字段#

data.vocal_removal_info.origin_url (string)#

原始音频URL

data.vocal_removal_info.vocal_url (string)#

主人声音频URL

data.vocal_removal_info.backing_vocals_url (string)#

背景人声音频URL(split_stem类型专有)

data.vocal_removal_info.drums_url (string)#

鼓声部分音频URL(split_stem类型专有)

data.vocal_removal_info.bass_url (string)#

贝斯部分音频URL(split_stem类型专有)

data.vocal_removal_info.guitar_url (string)#

吉他部分音频URL(split_stem类型专有)

data.vocal_removal_info.keyboard_url (string)#

键盘部分音频URL(split_stem类型专有)

data.vocal_removal_info.percussion_url (string)#

打击乐部分音频URL(split_stem类型专有)

data.vocal_removal_info.strings_url (string)#

弦乐部分音频URL(split_stem类型专有)

data.vocal_removal_info.synth_url (string)#

合成器部分音频URL(split_stem类型专有)

data.vocal_removal_info.fx_url (string)#

效果器部分音频URL(split_stem类型专有)

data.vocal_removal_info.brass_url (string)#

铜管部分音频URL(split_stem类型专有)

data.vocal_removal_info.woodwinds_url (string)#

木管部分音频URL(split_stem类型专有)

回调接收示例#

以下是常用编程语言接收回调的示例代码:
Node.js

最佳实践#

回调URL配置建议#

1.
使用HTTPS: 确保回调URL使用HTTPS协议以保证数据传输安全
2.
验证来源: 在回调处理中验证请求来源的合法性
3.
幂等处理: 同一task_id可能收到多次回调,确保处理逻辑是幂等的
4.
快速响应: 回调处理应尽快返回200状态码以避免超时
5.
异步处理: 复杂的业务逻辑应异步处理以避免阻塞回调响应
6.
分类处理: 根据不同的分离类型处理不同的音频文件结构
7.
批量下载: split_stem类型产生多个文件,建议批量下载并按类型整理

重要提醒#

回调URL必须是公开可访问的地址
服务器必须在15秒内响应,否则将被认为超时
如果连续3次重试失败,系统将停止发送回调
请确保回调处理逻辑的稳定性,避免因异常导致回调失败
人声分离生成的音频文件URL可能有时效性,建议及时下载保存
注意检查各个音频部分的URL是否可用,某些乐器分离可能为空
separate_vocal和split_stem类型返回的字段不同,请根据请求时的type参数处理相应字段

故障排查#

如果您未收到回调通知,请检查以下内容:
网络连接问题
确认回调URL可以从公网访问
检查防火墙设置,确保入站请求未被阻止
验证域名解析是否正确
服务器响应问题
确保服务器在15秒内返回HTTP 200状态码
检查服务器日志是否有错误消息
验证接口路径和HTTP方法是否正确
内容格式问题
确认收到的POST请求体为JSON格式
检查 Content-Type 是否为 application/json
验证 JSON 解析是否正确
文件处理问题
确认各个音频文件URL是否可访问
检查文件下载权限和网络连接
验证文件保存路径和权限
注意某些乐器分离结果可能为空的情况
注意separate_vocal和split_stem类型的字段差异

替代方案#

如果无法使用回调机制,您也可以使用轮询方式:
轮询查询结果
使用获取人声分离详情端点定期查询任务状态。我们建议每30秒查询一次。
Previous
获取WAV转换详情
Next
MIDI 生成回调
Built with