概述
所有异步生成接口都接受可选的callback_url 参数。任务完成(成功或失败)后,服务器会向该 URL 发送一次 POST 请求,携带任务结果。
这样你就可以完全省去轮询操作。
回调 Payload
音乐生成成功
任务失败
Payload 字段说明
支持回调的接口
音频处理接口(
/stem、/midi、/timeline、/waveform、/wav)为同步接口,不支持 callback_url。签名验证
每次回调请求都包含X-Signature 请求头,用于验证请求来源的合法性:
HMAC-SHA256(原始请求体, signing_secret)
signing_secret 在创建 AppKey 时仅显示一次,请妥善保存。
示例 — Node.js:
可靠性
- 服务器最多重试失败的回调 5 次,采用指数退避策略(30s、60s、120s、300s、600s)。
- 你的接口必须在 10 秒内返回 HTTP
2xx,否则本次投递视为失败。 - 所有重试耗尽后,可通过 获取任务 手动查询结果。