任务回调
新版和旧版任务均可使用回调,但客户端应始终保留主动查询作为补偿机制。
新版任务
创建任务时传入公开可访问的 HTTP/HTTPS 地址:
json
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "电影感城市夜景"}
],
"resolution": "720p",
"duration": 5,
"callback_url": "https://your.example.com/webhooks/seedance"
}回调内容以任务状态响应为准。收到通知后,建议再使用任务 ID 查询一次最终状态和完整结果。
接收端要求
- 使用解析到公网地址的 HTTPS 80/443 端点。平台会拒绝内网、回环、本地路径、非 HTTP 协议和自定义端口。
- 先返回 2xx,再异步执行耗时业务。
- 按任务 ID 幂等处理;同一终态可能重复通知。
- 不要只依赖回调。网络、网关和业务超时都可能导致通知丢失。
- 对长时间未收到回调的任务主动轮询,直到进入终态。
旧版任务的 callback_url 字段和接口继续保留,具体格式见旧版任务回调。