旧版任务回调

创建旧版任务时可以传入 callback_url：

curl -X POST "https://www.dianlitoken.com/v1/videos" \
  -H "Authorization: Bearer $DIANLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.0-pro",
    "content":[{"type":"text","text":"雨后的城市街道，镜头缓慢推进"}],
    "duration":5,
    "callback_url":"https://your.example.com/webhooks/seedance"
  }'

回调用于减少轮询等待，但不能替代查询接口。业务端必须保存创建响应中的任务 ID，并以 GET /v1/videos/{task_id} 作为状态补偿和最终结果来源。

回调请求

平台以 POST 和 application/json 发送状态通知。任务信息位于 data：

{
  "callbackType": "video_task_status",
  "callbackUrl": "https://your.example.com/webhooks/seedance",
  "data": {
    "id": "cgt_xxx",
    "status": "succeeded",
    "content": {
      "video_url": "https://example.com/result.mp4"
    },
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9",
    "usage": {
      "completion_tokens": 40594,
      "total_tokens": 40594
    }
  }
}

使用 data.id 识别任务，使用 data.status 判断状态。收到通知后再查询 GET /v1/videos/{data.id}，取得旧版标准查询结果。

接收端要求

• 使用公网可访问的 HTTPS 地址。
• 快速返回 2xx，不要在回调请求中执行耗时任务。
• 按任务 ID 幂等处理重复通知。
• 不要假设通知严格按状态顺序到达。
• 回调异常或超时时继续使用查询接口。