SubmitIProductionJob - 提交智能生产任务

调用SubmitIProductionJob提交智能生产任务。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ice:SubmitIProductionJob
  • 全部资源
    *

请求参数

名称类型必填描述示例值
Namestring

任务名称,长度不超过 100 字符。

测试任务
FunctionNamestring

需要使用的算法功能名称。取值:

  • Cover:智能封面
  • VideoClip:视频摘要
  • VideoDelogo:视频去图标
  • VideoDetext:视频去字幕
  • CaptionExtraction:字幕提取
  • VideoGreenScreenMatting:绿幕抠图
  • FaceBeauty:视频美颜
  • VideoH2V:视频横转竖
  • MusicSegmentDetect:副歌检测
  • AudioBeatDetection:节奏检测
  • AudioQualityAssessment:音质检测
  • SpeechDenoise:语音降噪
  • AudioMixing:音频混音
  • MusicDemix:声伴分离
Cover
Inputobject

输入媒体,支持 OSS 或媒资 ID。

Typestring

媒体类型:

  • OSS:OSS 路径

  • Media:媒资 ID

OSS
Mediastring

输入媒体,支持 OSS 地址和媒资 ID 两种。 oss 地址规则为

  1. oss://bucket/object
  2. http(s)://bucket.oss-[regionId].aliyuncs.com/object 其中 bucket 为和当前项目处于同一区域的 oss bucket 名称,object 为文件路径。
oss://bucket/object
Outputobject

输出媒体,支持 OSS 或媒资 ID。

Typestring

媒体类型:

  • OSS:OSS 路径

  • Media:媒资 ID

OSS
Mediastring

输出媒体。当 Type 为 OSS 时填入 OSS 地址,Type 为 Media 时填入媒资 ID。 OSS 地址规则为:

  1. oss://bucket/object
  2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object 其中 bucket 为和当前项目处于同一区域的 oss bucket 名称,object 为文件路径。
oss://bucket/object
TemplateIdstring

模板 ID

****20b48fb04483915d4f2cd8ac****
JobParamsstring

算法作业参数,JSON 对象,不同算法对应参数内容不同。详见补充说明。

{"Model":"gif"}
ScheduleConfigobject

任务调度配置信息

PipelineIdstring

管道 ID

5246b8d12a62433ab77845074039c3dc
Priorityinteger

取值范围为 1 到 10,数值越小优先级越高。

6
UserDatastring

用户自定义数据,获取结果时原样返回。长度不超过 1024 字节。

{"test":1}
ModelIdstring

算法模型 ID。如果为空,则选择对应功能的默认模型(此参数保持为空即可,一般无需传入,直接使用默认模型)。

JobParams 的 JSON 字段说明

Cover

  • Model:String 类型,智能封面模型,为空时输出图片封面,为 gif 时输出动图封面。
  • LogoModel:String 类型,去除的 logo 类型,取值:tv(通用台标 - 电视台),internet(通用台标 - 网络媒体),该字段可多选,通过逗号分隔。
  • Boxes:String 类型,目标 logo 框位置,以左上角为原点的归一化距离,[xmin, ymin, width, height],目前最多支持两个目标 logo 框,例如:"[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]"。

VideoDetext

  • LimitRegion:list 类型,限定字幕检测区域,以左上角为原点的归一化距离,[xmin, ymin, width, height],可支持多个检测区域,例如:[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]。注意,不设置该参数时,默认检测区域为视频下方 30%区域。
  • Time:指定全局擦除时间(单位 s),list 类型,包括起始时间和结束时间,[start_time, end_time],例如[[5, 20],表示只擦除视频的 5~20 秒之间的字幕。

CaptionExtraction

  • fps:采样帧率(可选),整数,取值范围为[2,10],默认 5。
  • roi:字幕框选区域(只对区域内的字幕进行提取),格式:[[top, bottom], [left, right]],为归一化取值(如下半部分[[0.5, 1], [0, 1]])。不传此值,默认识别视频底部 1/4 区域。
  • lang:识别语言,ch(中文)、en(英文),ch_ml(中英混合)。默认 ch。
  • track:如果传"main",表示只提取主字幕轨道。不传时,默认提取区域内出现的所有字幕。

VideoGreenScreenMatting

  • bgimage:抠图后叠加的背景图片,例如:http://example-image-****.example-location.aliyuncs.com/example/example.jpg。如果不传该参数,则输出带透明通道的 WEBM 视频。

FaceBeauty

  • beauty_params:美颜功能参数,填写示例: "whiten=20,smooth=50,face_thin=50",详见参数字段说明

VideoH2V

MusicSegmentDetect

AudioBeatDetection

AudioQualityAssessment

SpeechDenoise

输入音频要求:格式需为 WAV,采样率为 16khz 或 48khz。

AudioMixing

  • inputs:待混合的音轨文件地址列表,目前只支持一个,例如:{"file":"http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/2.mp4"}

MusicDemix

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID

C1849434-FC47-5DC1-92B6-F7EAAFE3851E
JobIdstring

智能任务 ID

****20b48fb04483915d4f2cd8ac****

示例

正常返回示例

JSON格式

{
  "RequestId": "C1849434-FC47-5DC1-92B6-F7EAAFE3851E",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-07-13新增 OpenAPI查看变更详情