Skip to main content
当任务到达终态（SUCCESS / FAILURE / TIMEOUT / CANCELLED）时，如果提交时指定了 callBackUrl，系统会向该地址发送 POST 请求。

​
回调格式

POST <callBackUrl>
Content-Type: application/json
回调 data 字段与查询接口响应格式完全一致：
成功
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "SUCCESS",
    "input": {
      "model": "seedance-2.0-fast",
      "prompt": "a cat walking in the garden",
      "ratio": "16:9",
      "resolution": "1080p",
      "duration": 10
    },
    "result": {
      "type": "video",
      "urls": ["https://media.example.com/videos/2026/02/26/a1b2c3d4.mp4"]
    },
    "failure_reason": null,
    "created_at": "2026-02-26T07:42:43Z",
    "updated_at": "2026-02-26T10:12:55Z"
  }
}
失败（内容审核）
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "FAILURE",
    "input": {
      "model": "seedance-2.0-fast",
      "prompt": "...",
      "ratio": "16:9",
      "resolution": "1080p",
      "duration": 10
    },
    "result": null,
    "failure_reason": "CONTENT_MODERATION",
    "created_at": "2026-02-26T07:42:43Z",
    "updated_at": "2026-02-26T07:42:55Z"
  }
}

​
result 字段结构

SUCCESS 时：
字段类型说明
typestring结果类型：image（图片）或 video（视频）
urlsstring[]资源 URL 列表。图片可能多张，视频通常 1 个。链接有效期 7 天
FAILURE / TIMEOUT / CANCELLED 时： result 为 null。

​
failure_reason

始终存在于响应中，无特定可操作原因时为 null。 枚举值：
值含义建议处理方式
CONTENT_MODERATIONPrompt 或图片因包含真人人脸、受版权保护的人物或公众人物，或 NSFW 内容而被拒绝告知用户内容违规；不要重试
INVALID_PARAMETERS传入参数不正确。对于 Seedance 素材生视频，请优先检查这些规则：mediaUrls 必须传入 1 到 12 个素材 URL，图片最多 9 张，上传视频总时长不能超过 15 秒，上传音频总时长不能超过 15 秒修正请求参数后再提交；不要直接重试
INSUFFICIENT_POINTS账户积分不足引导用户充值；不要重试
null无特定可操作原因（瞬态错误、超时等）视情况可重试

​
注意事项

  • Webhook 超时时间为 5 秒，异步发送不阻塞主流程
  • 发送失败仅记录日志，不会重试
  • callBackUrl 不支持 localhost / 127.0.0.1 等内网地址（SSRF 防护）
  • 外层 code 始终为 0，需要通过 data.status 判断成功或失败