Callback协议
更新时间:2025-06-13
对于异步任务(图像生成 / 视频生成 等),如果在创建任务时主动设置了callback_url,则当任务状态发生变更时、服务端会主动通知,协议如下。
JSON
1{
2 "task_id": "string", //任务ID,系统生成
3 "task_status": "string", //任务状态,枚举值:submitted(已提交)、processing(处理中)、succeed(成功)、failed(失败)
4 "task_status_msg": "string", //任务状态信息,当任务失败时展示失败原因(如触发平台的内容风控等)
5 "task_info":{ //任务创建时的参数信息
6 "parent_video": {
7 "id": "string", //续写前的视频ID;全局唯一
8 "url": "string", //续写前视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
9 "duration": "string" //续写前的视频总时长,单位s
10 },
11 "external_task_id": "string"//客户自定义任务ID
12 }, //任务创建时用户填写的详细信息
13 "created_at": 1722769557708, //任务创建时间,Unix时间戳、单位ms
14 "updated_at": 1722769557708, //任务更新时间,Unix时间戳、单位ms
15 "task_result":{
16 "images":[ //图片类任务的结果
17 {
18 "index": int, //图片编号
19 "url": "string" //生成图片的URL,例如:https://h1.ink***ng(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
20 }
21 ],
22 "videos":[ //视频类任务的结果
23 {
24 "id": "string", //视频ID;全局唯一
25 "url": "string", //视频的URL(请注意,为保障信息安全,生成的图片/视频会在30天后被清理,请及时转存)
26 "duration": "string" //视频总时长,单位s
27 }
28 ]
29 }
30}
