跳转到主要内容

概述

所有异步生成接口都接受可选的 callback_url 参数。任务完成(成功或失败)后,服务器会向该 URL 发送一次 POST 请求,携带任务结果。 这样你就可以完全省去轮询操作。

回调 Payload

音乐生成成功

任务失败

Payload 字段说明

支持回调的接口

音频处理接口(/stem/midi/timeline/waveform/wav)为同步接口,不支持 callback_url

签名验证

每次回调请求都包含 X-Signature 请求头,用于验证请求来源的合法性:
算法: HMAC-SHA256(原始请求体, signing_secret) signing_secret 在创建 AppKey 时仅显示一次,请妥善保存。 示例 — Node.js:
示例 — Python:

可靠性

  • 服务器最多重试失败的回调 5 次,采用指数退避策略(30s、60s、120s、300s、600s)。
  • 你的接口必须在 10 秒内返回 HTTP 2xx,否则本次投递视为失败。
  • 所有重试耗尽后,可通过 获取任务 手动查询结果。
建议立即返回 200 OK,异步处理回调内容。响应缓慢会导致不必要的重试。