You need to enable JavaScript to run this app.
文档中心
复制全文
下载 pdf
API接入
异步回调
复制全文
下载 pdf
异步回调
应用场景​
  • 避免轮询查询任务状态​
  • 任务生成成功或失败时,需要即刻知晓任务状态​
使用说明:​
创建人声歌曲或纯音乐时,传入CallbackURL参数。在任务执行完成后,服务会通过POST请求回调传入的CallbackURL接口,告知任务状态、失败原因。​
异步回调请求参数:​
​
{​
"CallbackTime": 1724984476, // 回调时间,单位s​
"TaskID": "202408308513817850019840", // 任务ID​
"Status": 3, // 任务状态 2->成功, 3->失败​
"FailureReason": { // 任务失败原因,任务执行成功时为null​
"Code": 100001,​
"Msg": ""​
},​
"SongDetail": {​
"AudioUrl": "xxxxx", // 音频地址 URL域名规则:v{1-50}-default.douyinvod.com​
"Captions": "{}", // 歌词字幕​
"Lyrics": "xxxxxxx", // 生成歌曲所使用的歌词​
"Duration": 46.0024375 // 音频时长,单位秒​
"Genre":"",//曲风​
"Mood":"",//情绪​
"Gender":"",//性别​
"TosPath":"",//用户自定义tos保存路径​
"CallbackURL":"",//回调地址​
"Timbre":"",//音色​
"Prompt":""//提示词​
}​
}​
​
响应信息:​
​
{​
"code": 200,//状态 200代表成功,非200代表失败​
"message": ""//失败原因(允许只有非200有值)​
}​
​
说明​
  • 在异步回调请求交互时,如果响应状态非200,则表明回调失败,会定期重新发起通知(最多重试2次),通知的间隔频率为:5m、10m。​
  • 回调接口请求使用的POST方式发送回调信息,数据格式为Json。​
Demo:​
  • Golang:​
​
​
SongTaskCallBackService.zip
​
​
  • Java:​
​
​
SongTaskCallBackService.zip
​
​
  • Python:​
​
​
SongTaskCallBackService.zip
​
​
注:未提供demo的编程语言,烦请根据文档说明和参照curl示例、已有语言demo示例自行编写。​
最近更新时间:2026.01.30 19:12:52
这个页面对您有帮助吗?
有用
有用
无用
无用