Callback协议
对于异步任务(图像生成 / 视频生成),若您在创建任务时主动设置了callback_url,则当任务状态发生变更时、服务端会主动通知,协议如下
json
{
"task_id": "string", //任务ID(系统生成)
"task_status": "string", //任务状态,枚举:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
"task_status_msg": "string", //任务状态信息;失败时给出原因(如触发平台内容风控)
"created_at": 1722769557708, //任务创建时间,Unix 毫秒时间戳
"updated_at": 1722769557708, //任务更新时间,Unix 毫秒时间戳
"task_result":{
"images":[ //图片类任务结果
{
"index": int, //图片序号,0-9
"url": "string" //生成图片的 URL,例如 https://<资源域名>/xxx.png
}
],
"videos":[ //视频类任务结果
{
"id": "string", //视频 ID,全局唯一
"url": "string", //视频 URL
"duration": "string" //视频总时长,单位秒
}
]
}
}
说明:回调地址由创建任务时的
callback_url指定;请确保该地址可从公网访问并能正确响应。