跳到主要内容

查询素材拉取任务详情

1.接口说明​

此接口用于查询素材拉取任务的详情

2.请求地址​

https://digitbot.bokecc.com/api/material/fetchtask/get

3.请求方式​

GET

4.请求参数​

(1).公共参数，参考服务说明。​

(2).接口参数​

①.Query参数：通过URL参数传递。​

参数名类型必需说明
versionString是接口版本号，当前支持版本：1.0.0。
taskIdString是任务id

5.请求示例​

GET https://digitbot.bokecc.com/api/material/fetchtask/get?accountId=xxx&version=1.0.0&taskId=xxxx&hash=xxx&time=xxx HTTP/1.1

6.响应示例​

{
    "id": "xxx",
    "projectId": "xxxxx",
	"type": 1,
    "fileUrl": "xxxxxxxx"
    "filename": "春天.png",
    "callbackUrl": "xxxxxxxxxxxxxxxx",
    "businessId": "8888"
	"status": 10,
    "recordId": "xxxxxxxx",
    "createTime": "2024-03-25 12:10:05",
}

7.响应说明​

字段名类型说明
idString任务id
projectIdString项目id
typeInteger素材类型，1=自定义图片背景、2=自定义视频背景、3=自定义图片贴纸、4=驱动音频、5=ppt文档
fileUrlString文件地址
filenameString文件名
callbackUrlString素材拉取结果回调地址
businessIdString透传业务id
statusInteger任务状态：-10=拉取失败, 0=拉取中, 10=拉取成功
recordIdString关联记录id, status=10时返回，type=1时为自定义图片背景id,type=2时为自定义视频背景id, type=3时为自定义图片贴纸id,type=4时为驱动音频id, type=5时为ppt文档id,
failReasonString失败描述，如文件地址错误、文件解析失败等， status=-10时返回
createTimeString任务创建时间，格式：yyyy-MM-dd HH:mm:ss

拉取成功说明:

拉取成功指最终的结果成功，除了将文件拉取外，还包含一些解析操作。

  • type为自定义图片背景或自定义图片贴纸时指图片转存到oss并获取到图片宽高信息。

  • type为自定义视频背景时指视频转存到oss并获取到视频时长等信息。

  • type为驱动音频时指音频转存到oss并获取到音频时长等信息，经过语音转写提取完字幕。

  • type为ppt文档时指ppt文档转存到数字人文档服务器并解析成图片完成。