## 应用场景 * 避免轮询查询任务状态 * 任务生成成功或失败时，需要即刻知晓任务状态 ## 使用说明：创建人声歌曲或纯音乐时，传入CallbackURL参数。在任务执行完成后，服务会通过POST请求回调传入的CallbackURL接口，告知任务状态、失败原因。 ## 异步回调请求参数： ```JSON { "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":""//提示词 } } ``` ## 响应信息： ```JSON { "code": 200,//状态 200代表成功，非200代表失败 "message": ""//失败原因（允许只有非200有值） } ``` :::tip * 在异步回调请求交互时，如果响应状态非200，则表明回调失败，会定期重新发起通知（最多重试2次），通知的间隔频率为：5m、10m。 * 回调接口请求使用的POST方式发送回调信息，数据格式为Json。 ::: ## Demo： * **Golang：** * **Java：** * **Python：** :::danger 注：未提供demo的编程语言，烦请根据文档说明和参照curl示例、已有语言demo示例自行编写。 :::

音视频理解与处理