众扬汇 AI 开放平台 API 文档

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 指定;请确保该地址可从公网访问并能正确响应。