调用SubmitIProductionJob提交智能生产任务。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ice:SubmitIProductionJob |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Name | string | 否 | 任务名称,长度不超过 100 字符。 | 测试任务 |
FunctionName | string | 是 | 需要使用的算法功能名称。取值:
| Cover |
Input | object | 是 | 输入媒体,支持 OSS 或媒资 ID。 | |
Type | string | 是 | 媒体类型:
| OSS |
Media | string | 是 | 输入媒体,支持 OSS 地址和媒资 ID 两种。 oss 地址规则为
| oss://bucket/object |
Output | object | 是 | 输出媒体,支持 OSS 或媒资 ID。 | |
Type | string | 是 | 媒体类型:
| OSS |
Media | string | 是 | 输出媒体。当 Type 为 OSS 时填入 OSS 地址,Type 为 Media 时填入媒资 ID。 OSS 地址规则为:
| oss://bucket/object |
TemplateId | string | 否 | 模板 ID | ****20b48fb04483915d4f2cd8ac**** |
JobParams | string | 否 | 算法作业参数,JSON 对象,不同算法对应参数内容不同。详见补充说明。 | {"Model":"gif"} |
ScheduleConfig | object | 否 | 任务调度配置信息 | |
PipelineId | string | 否 | 管道 ID | 5246b8d12a62433ab77845074039c3dc |
Priority | integer | 否 | 取值范围为 1 到 10,数值越小优先级越高。 | 6 |
UserData | string | 否 | 用户自定义数据,获取结果时原样返回。长度不超过 1024 字节。 | {"test":1} |
ModelId | string | 否 | 算法模型 ID。如果为空,则选择对应功能的默认模型(此参数保持为空即可,一般无需传入,直接使用默认模型)。 |
JobParams 的 JSON 字段说明
Cover
- Model:String 类型,智能封面模型,为空时输出图片封面,为 gif 时输出动图封面。
VideoDelogo
- 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
无
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "C1849434-FC47-5DC1-92B6-F7EAAFE3851E",
"JobId": "****20b48fb04483915d4f2cd8ac****"
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2022-07-13 | 新增 OpenAPI | 查看变更详情 |