# Callback协议

## 对于异步任务（图像生成 / 视频生成），若您在创建任务时主动设置了callback\_url，则当任务状态发生变更时、服务端会主动通知，协议如下

```
{
  "task_id": "string", //任务ID，系统生成
  "task_status": "string", //任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
  "task_status_msg": "string", //任务状态信息，当任务失败时展示失败原因（如触发平台的内容风控等）
  "created_at": 1722769557708, //任务创建时间，Unix时间戳、单位ms
  "updated_at": 1722769557708, //任务更新时间，Unix时间戳、单位ms
  "task_result":{
  	"images":[ //图片类任务的结果
      {
        "index": int, //图片编号，0-9
        "url": "string" //生成图片的URL，例如：https://h1.inkwai.com/bs2/upload-ylab-stunt/1fa0ac67d8ce6cd55b50d68b967b3a59.png
      }
    ],
    "videos":[ //视频类任务的结果
  		{
        "id": "string", //视频ID；全局唯一
    		"url": "string", //视频的URL
        "duration": "string" //视频总时长，单位s
      }
  	]
	}
}
```
