TUIWOTUIWO
API字节跳动Seedance 系列模型

回调

接收任务终态通知。

配置

创建任务时传入 callback_url:

{
  "model": "<seedance-model-id>",
  "content": [{"type": "text", "text": "..."}],
  "callback_url": "https://example.com/tuiwo/callback"
}

要求

  • 必须是公网可访问的 HTTPS 地址;
  • 平台会做 SSRF 校验,私网/本机地址会被拒绝;
  • 仅在任务进入终态后投递;
  • 至少投递一次,最长在 24 小时内重试;
  • 没有入站回调管理接口,也没有回调签名密钥。

载荷

回调体是任务对象,字段与查询接口一致。请以 id / task_id 关联任务,并自行实现幂等处理。

注意

  • 回调地址会随任务保存;修改地址需要重新创建任务。
  • 如果回调失败,任务状态仍可通过查询接口获取,不依赖回调。