查看任务进度
# 说明
查询创建视频任务进度,成功后返回视频链接
- 【重要】该接口允许轮训,但请设置合理轮训间隔,建议1s,过于频繁可能会触发限流
- 【重要】测试环境视频链接允许公网访问,正式环境受防盗链限制,请提前告知万木方访问域名以便加入资源白名单
# 请求(get)
/digital-video-order/progress
# 参数
参数 | 类型 | 是否必须 | 长度 | 说明 | 默认值 |
---|---|---|---|---|---|
taskId | string | 是 | <64 | 任务ID,由创建任务成功后返回 | - |
# 请求示例
{URL}?taskId=232b7af7cbf74b0883cc95c3a7ea76d1
# 返回字段
data:
字段 | 类型 | 说明 |
---|---|---|
taskId | string | 本次生成任务的ID |
progress | int | 生成进度,0-100,100时表示生成成功,会携带视频信息返回 |
videoUrl | string | 视频地址,一般为mp4格式,来自万木健康OSS 由于防盗链策略,请在项目上线前提前告知万木方访问域名(即在哪个域名下展示该视频) 生产环境资源示例:https://static.prod.vanmul.com/north/vanmulhealth/2023-07-26/1684198881194987520.mp4 如果能顺利通过指定域名访问,即表示防盗链配置成功。封面图片同理 |
videoCover | string | 视频封面,一般为jpg格式,来自万木健康OSS 由于防盗链策略,请在项目上线前提前告知万木方访问域名(即在哪个域名下展示该封面图) |
duration | int | 视频时长,单位:毫秒 |
videoAlphaUrl | string | 绿幕视频支持alpha通道视频输出 |
subtitle | string | 字幕文件,ASS格式 |
customizedCover | string | 定制封面图,由接入方提前与万木沟通确认设计方案,格式同videoCover |
# 返回示例
//生成中时
{
"code": 1,
"msg": "操作成功!",
"success": true,
"data": {
"taskId": "232b7af7cbf74b0883cc95c3a7ea76d1",
"progress": 20,
"videoCover": null,
"videoUrl": null,
"videoAlphaUrl": null,
"subtitle": null,
"duration": 0
}
}
//生成成功时
{
"code": 1,
"msg": "操作成功!",
"success": true,
"data": {
"taskId": "232b7af7cbf74b0883cc95c3a7ea76d1",
"progress": 100,
"videoUrl": "http://static.vanmul.com/north/vanmulhealth/2023-07-26/1684200158268280832.mp4",
"videoCover": "http://static.vanmul.com/north/vanmulhealth/2023-07-26/1684200158268280832.jpg",
"videoAlphaUrl": "http://xxxxxxxxxxxxx.mp4",
"subtitle": "http://xxxxxxxxx.ass",
"duration": 5520,
"customizedCover": "http://static.vanmul.com/north/vanmulhealth/2023-07-26/1684200158268280832.jpg"
}
}
# 常见错误码
code | 说明 |
---|---|
16009 | 任务id有误,请使用创建视频任务下发的任务id |
上次更新: 2024/09/23, 15:33:43