API 文档

任务

最近更新时间:2020-09-15 17:23:00

简介

针对已存在于存储桶中的文件,您可创建任务进行媒体处理操作。目前支持创建文件转码视频截帧视频转动图智能封面四种任务。任务创建基于模板功能,您可直接使用数据万象提供的系统预设模板,也可自定义模板,模板详情请见 模板文档

说明:

  • 目前任务功能仅能对存量文件进行操作,若您需要在上传时对文件进行操作,请使用 工作流 功能。
  • 创建任务后,会产生相应的功能费用。计费详情请查看 媒体处理计费文档
  • 使用媒体处理服务需保证资源可用,请勿开启 原图保护防盗链 等访问限制功能。

查看任务

您可在任务页面查看指定时间段内的所有任务。同时您可单击【作业状态】查看不同状态下的任务;您也可在【搜索框】通过任务 ID 查找指定任务。单击任务右侧的【查看】按钮,可查看任务的以下信息:

  • 机器配置:任务 ID、队列 ID、模板 ID、任务创建时间、任务结束时间。
  • 输入信息:被处理视频所在的存储桶、存储桶地域、被处理文件的存储路径。
  • 输出信息:媒体地址、输出文件所在存储桶、存储桶地域、输出文件的存储路径。
说明:

任务一共包括6种状态:执行成功、执行失败、执行中、未执行、已暂停、已取消。

创建文件转码任务

文件转码提供图片、文档等媒体类文件的转码能力,是文件码流转换成另一个码流的过程。通过转码,可以改变原始码流的编码格式、分辨率和码率等参数,从而适应不同终端和网络环境的播放。

操作步骤

  1. 登录 数据万象控制台 ,单击【存储桶管理】,进入存储桶管理页面。
  2. 在【存储桶管理】页面,选择并单击需操作的存储桶名称,进入相应存储桶管理页面。
  3. 单击左侧导航栏【媒体处理】页签,选择界面上方的【任务】,切换至任务管理页面。
  4. 单击【创建任务】,选择任务类型为文件转码,然后按照如下配置项说明进行配置:
    • 输入存储桶:默认项,即为当前存储桶。
    • 文件路径:需要您输入被处理文件的路径,注意文件路径以 / 开头,以 / 分割文件夹,不允许以 / 结尾。
    • 队列:目前只支持默认队列 queue-1,队列相关说明请查看 队列文档
    • 输出存储桶:支持选择同地域下开通了媒体处理功能的存储桶。
    • 输出文件路径:您可在此处指定输出文件的保存路径和文件名。
    • 模板类型:可选择系统预设模板或自定义模板。
    • 选择模板:您可选择指定模板。

创建视频截帧任务

视频截帧为数据万象提供的视频某一时间节点的截图功能,控制台开启任务输出的截图统一为 jpeg 格式。

说明:

视频截帧任务基于模板功能,您可利用自定义视频截帧模板对截帧开始时间点、截帧间隔、截帧数量、输出图片尺寸、输出格式等进行自定义设置。

操作步骤

  1. 登录 数据万象控制台,单击【存储桶管理】,进入存储桶管理页面。
  2. 在【存储桶管理】页面,选择并单击需操作的存储桶名称,进入相应存储桶管理页面。
  3. 单击左侧导航栏【媒体处理】页签,选择页面上方的【任务】,切换至任务管理页面。
  4. 单击【创建任务】,选择任务类型为视频截帧,然后按照如下配置项说明进行配置:
    • 输入存储桶:默认项,即为当前存储桶。
    • 文件路径:需要您输入被处理文件的路径,注意文件路径以 / 开头,以 / 分割文件夹,不允许以 / 结尾。
    • 队列:目前只支持默认队列 queue-1,队列相关说明请查看 队列文档
    • 输出存储桶:支持选择与同地域下已开通媒体处理的存储桶。
    • 输出文件路径:您可在此处指定输出文件的保存路径和文件名。注意智能截帧的输出文件数量大于1,因此输出文件名必须包含${Number}参数作为截图序号。例如输出文件路径设置为 test-${Number}.jpg,任务截取两张截图,则实际输出文件名为 test-0.jpg、test-1.jpg。
    • 输出格式:目前控制台开启视频截帧任务仅支持输出 JPEG 格式截图,使用视频截帧 API 可选择输出 JPG 或 PNG 格式截图,详情请查看 视频截帧 API 文档。
    • 模板类型:您可选择系统模板或自定义模板。模板相关说明请查看 模板文档
    • 选择模板:您可选择指定模板。

创建视频转动图任务

您可利用视频转动图功能将视频格式转为动图格式。

说明:

视频转动图任务基于模板功能,您可利用自定义视频转动图模板对开始转码时间、转码时长、抽帧方式、输出动图帧率、输出动图尺寸、输出格式等进行自定义设置。

操作步骤

  1. 登录 数据万象控制台 ,单击【存储桶管理】,进入存储桶管理页面。
  2. 在【存储桶管理】页面,选择并单击需操作的存储桶名称,进入相应存储桶管理页面。
  3. 单击左侧导航栏【媒体处理】页签,选择界面上方的【任务】,切换至任务管理页面。
  4. 单击【创建任务】,选择任务类型为视频转动图,然后按照如下配置项说明进行配置:
    • 输入存储桶:默认项,即为当前存储桶。
    • 文件路径:需要您输入被处理文件的路径,注意文件路径以 / 开头,以 / 分割文件夹,不允许以 / 结尾。
    • 队列:目前只支持默认队列 queue-1,队列相关说明请查看 队列文档
    • 输出存储桶:支持选择同地域下已开通媒体处理的存储桶。
    • 输出文件路径:您可在此处指定输出文件的保存路径和文件名。
    • 模板类型:您可选择系统模板或自定义模板。模板相关说明请查看 模板文档
    • 选择模板:您可选择指定模板。

创建智能封面任务

智能封面功能集成腾讯云音视频实验室先进的 AI 技术,通过对视频内容的理解,智能分析视频帧的质量、精彩程度、内容相关度,提取最优帧生成截图作为封面,提升内容吸引力。

说明:

  • 智能封面是付费服务,按照视频时长进行计费,具体费用请参见 计费与定价
  • 数据万象为每个账户提供每月500分钟的免费体验额度,超出后将正常计费。未使用额度不会累积至下一月。
  • 每个视频文件将智能分析输出3张最优的关键帧。
  • 数据万象也提供创建任务接口,可以根据参数进行配置,详情请参考 CreateMediaJobs API 文档。

操作步骤

  1. 登录 数据万象控制台 ,单击【存储桶管理】,进入存储桶管理页面。
  2. 在【存储桶管理】页面,选择并单击需操作的存储桶名称,进入相应存储桶管理页面。
  3. 单击左侧导航栏【媒体处理】页签,选择界面上方的【任务】,切换至任务管理页面。
  4. 单击【创建任务】,选择任务类型为智能封面,然后按照如下配置项说明进行配置:
    • 输入存储桶:默认项,即为当前存储桶。
    • 文件路径:需要您输入被处理文件的路径,注意文件路径以 / 开头,以 / 分割文件夹,不允许以 / 结尾。
    • 队列:目前只支持默认队列 queue-1,队列相关说明请查看 队列文档
    • 输出存储桶:支持选择同地域下已开通媒体处理的存储桶。
    • 输出文件路径:您可在此处指定输出文件的保存路径和文件名。注意,智能封面的输出文件数量大于1,因此输出文件名必须包含${Number}参数作为封面序号。如输出文件路径设置为test-${Number}.jpg,则实际输出文件名为 test-0.jpg、test-1.jpg
    • 模板类型:您可选择系统模板或自定义模板。模板相关说明请查看 模板文档
    • 选择模板:您可选择指定模板。
目录