调用SubmitBatchMediaProducingJob提交批量智能一键成片任务-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

接口说明

使用智能一键成片需要先购买【IMS 订阅服务】，详情请参见订阅计费制。
智能一键成片具体计费规则，详情请参见智能一键成片。
智能一键成片为异步接口，提交任务后返回任务 ID（此时任务尚未完成，任务将进入后台排队异步执行），最终结果将通过回调通知，也可通过获取批量智能一键成片任务信息主动查询任务状态。
智能一键成片提供【脚本化自动成片】、【智能图文匹配成片-通用场景版】、【智能图文匹配成片-影视集锦版】、【体育赛事集锦成片】、【高燃混剪成片】等多种解决方案，功能详情请参见智能一键成片。
脚本化自动成片与智能图文匹配成片共用同一个提交任务 API。有关如何通过参数区分这两者，请参见智能一键成片参数区别说明。
提交批量智能一键成片任务后，您可以调用 ListBatchMediaProducingJob 获取所有符合条件的一键成片任务列表。调用 GetBatchMediaProducingJob 获取任务详细信息，包括任务的状态、合成的媒资 ID 及 URL 等。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitBatchMediaProducingJob

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	调用方保证请求幂等性 Client Token	**12e8864746a0a398**
InputConfig	string	否	输入配置。具体结构定义，请参见 InputConfig 配置说明。	{ "MediaGroupArray": [{ "GroupName": "MediaGroup1", "MediaArray": [ "**9d46c886b45481030f6e", "6c886b4549d481030f6e" ] }, { "GroupName": "MediaGroup2", "MediaArray": [ "d46c886810b454930f6e", "4549d886810b46c30f6e**" ] }], "TitleArray": [ "回龙观盒马鲜生开业啦", "盒马鲜生开业啦" ], "SpeechTextArray": [ "附近的商场新开了一家盒马鲜生，今天是第一天开业" "商场里的人不少，零食、酒水都比较便宜大家也快来看看呀" ] }
EditingConfig	string	否	剪辑相关配置。具体结构定义，请参见 EditingConfig 配置说明。	{ "MediaConfig": { "Volume": 0 }, "SpeechConfig": { "Volume": 1 }, "BackgroundMusicConfig": { "Volume": 0.3 } }
OutputConfig	string	否	输出配置。具体结构定义，请参见 OutputConfig 配置说明。	{ "MediaURL": "http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4", "Count": 20, "MaxDuration": 15, "Width": 1080, "Height": 1920, "Video": {"Crf": 27} }
UserData	string	否	用户业务配置、回调配置。具体结构定义，请参见 UserData 配置说明。	{"NotifyAddress":"http://xx.xx.xxx"}或{"NotifyAddress":"https://xx.xx.xxx"}或{"NotifyAddress":"ice-callback-demo"}
TemplateConfig	string	否	模版参数。支持配置多个一键成片模版，随机选取应用。详情见 TemplateConfig 参数说明。	["**b4549d46c88681030f6e","549d46c88b4681030f6e**"]

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	**36-3C1E-4417-BDB2-1E034F**
JobId	string	批量智能一键成片作业 ID	**d80e4e4044975745c14b**

示例

正常返回示例

JSON格式

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "JobId": "****d80e4e4044975745c14b****"
}

错误码

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

变更历史

更多信息，参考变更详情。