提交智能生产作业接口,作业是异步执行方式,作业添加到管道中调度排队和执行。可以调用查询智能生产作业接口查询作业执行结果,也可以使用异步的消息通知机制。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必填 描述
Action String 操作接口名,系统规定参数,取值:SubmitIProductionJob。
FunctionName String 取值:
  • VideoH2V(视频横转竖)
  • VideoDelogo(视频去图标)
  • Cover(智能封面)
  • VideoClip(视频摘要)
  • ImageMatting(图片人像分割)
  • ImageH2V(横转竖)
  • ImageDelogo(图片去图标)
  • CaptionExtraction(字幕提取):算法输入待处理视频的url,输出提取的字幕文件。
  • VideoDetext(视频去字幕)
  • 绿幕抠图(VideoGreenScreenMatting):算法输入待抠图视频的url和替换的背景图片url,输出合成后的视频。
  • MusicSegmentDetect(副歌检测):算法输入待处理音频、视频的url,输出检测出的副歌起止时间。
ModelId String 算法模型id,如为空,则选择对应功能的默认模型。
Input String 输入文件路径,目前只支持oss,例如:oss://test-video.oss-cn-shanghai.aliyuncs.com/iproduction/test.mp4。
Output String 输出文件路径,目前只支持oss,例如:oss://test-video.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt,其中{source}、{timestamp}和{sequenceId}为占位符,分别填充输入文件名、Unix时间戳和生成序号;占位符不必须,但对多输出算法,比如智能封面等,需要注意加入序号占位符确保输出文件路径不重复;文件后缀名规则由用户自定义。
JobParams String 算法作业参数,包括不同算法对应参数,JSON对象。
PipelineId String 作业管道id,用以确认作业回调队列以及提供租户隔离能力。若不传,则使用默认管道,默认作业并发数10,不绑定消息通知。
UserData String 用户业务数据,callback时回传。
NotifyUrl String callback路径,目前只支持mns队列,例如:mns://1253406881704637.mns.cn-shanghai.aliyuncs.com/queues/test-pipeline。

返回参数

名称 类型 描述
JobId String 作业id

字幕提取:CaptionExtraction

JobParams参数说明:

名称 类型 是否必填 描述
fps Int 采样帧率(可选),默认5。
roi List 字幕框选区域,若输入框选区域,则只对区域内的字幕进行提取,区域外的文字忽略(可选)。格式:[[top, bottom], [left, right]],默认
sep Boolean 是否中英文分离输出两个srt文件,可选,默认False
formatter String srt的字幕格式字符串(可选),例如:"{\an8}",默认
回调示例
JSON格式
{"Code":"Success","Details":[],"FunctionName":"CaptionExtraction","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Succes

绿幕抠图:VideoGreenScreenMatting

JobParams参数说明:

名称 类型 是否必填 描述
mode String 替换的背景图片类型,默认填file
bgimage String 替换的背景图片,例如:http://test-image.oss-cn-shanghai.aliyuncs.com/iproduction/test.jpg

回调格式

JSON格式
{"Code":"Success","Details":[],"FunctionName":"VideoGreenScreenMatting","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

副歌检测:MusicSegmentDetect

JobParams参数说明:

名称 类型 是否必填 描述

回调格式

JSON格式
{"Code":"Success","Details":[],"FunctionName":"MusicSegmentDetect","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

VideoDetext:视频去字幕

JobParams参数说明:

名称 类型 是否必填 描述
Text String 目标字幕框位置,[bx, by, bw, bh],目前最多支持两个目标字幕框,例如:[[bx1, by1, bw1, bh1], [bx2, by2, bw2, bh2]]bx1:字幕框左上角点横坐标相对视频宽度比例,例:0.1by1:字幕框左上角点纵坐标相对视频高度比例,例:0.8bw1:字幕框宽度相对视频宽度比例,例:0.3bh1:字幕框高度相对视频高度比例,例:0.2bx2:字幕框左上角点横坐标相对视频宽度比例,例:0.5by2:字幕框左上角点纵坐标相对视频高度比例,例:0.8bw2:字幕框宽度相对视频宽度比例,例:0.3bh2:字幕框高度相对视频高度比例,例:0.2

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"VideoDetext","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

视频横转竖:VideoH2V

JobParams参数说明:

名称 类型 是否必填 描述

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"VideoH2V","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

视频去图标:VideoDelogo

JobParams参数说明:

名称 类型 是否必填 描述
Logo String 目标logo框位置,[xmin, ymin, width, height],目前最多支持两个目标logo框,例如:[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"VideoDelogo","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

智能封面:Cover

JobParams参数说明:

名称 类型 是否必填 描述
Model String 智能封面模型,为空时输出图片封面,为gif时输出动图封面。

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"Cover","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

视频摘要:VideoClip

JobParams参数说明:

名称 类型 是否必填 描述

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"VideoClip","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

图片人像分割:ImageMatting

JobParams参数说明:

名称 类型 是否必填 描述

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"ImageMatting","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

图片横转竖:ImageH2V

JobParams参数说明:

名称 类型 是否必填 描述

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"ImageH2V","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}

图片去图标:ImageDelogo

JobParams参数说明:

名称 类型 是否必填 描述

回调示例

JSON格式
{"Code":"Success","Details":[],"FunctionName":"ImageDelogo","JobId":"39f8e0bc005e4f309379701645f4744c","Message":"success","State":"Success","Type":"IProduction"}