GetBatchMediaProducingJob - 获取批量智能一键成片任务信息

获取批量智能一键成片作业的详细信息，包括作业的输入参数、任务状态、合成的媒资ID及URL。本接口仅支持查询近一年的任务数据。

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
ice:GetBatchMediaProducingJob	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
JobId	string	否	批量智能一键成片作业 ID	**b4549d46c88681030f6e**

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID	**36-3C1E-4417-BDB2-1E034F**
EditingBatchJob	object	批量智能一键成片任务信息
JobId	string	任务 ID	**b6b2750d4308892ac3330238**
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} }
Status	string	任务状态。取值范围： Init：初始化 Processing：处理中 Finished: 处理完成	Finished
UserData	string	用户业务配置、回调配置。具体结构定义，请参见 UserData 配置说明。	{"NotifyAddress":"http://xx.xx.xxx"}
Extend	string	扩展信息。字段详情： ErrorCode: 主任务错误码 ErrorMessage: 主任务错误信息	{ "ErrorCode": "InvalidMaterial.NotFound", "ErrorMessage": "The specified clips id not found:[\"**30d0b5e871eebb2ff7f6c75a**\"]" }
CreateTime	string	任务创建时间，UTC 时间格式	2024-06-13T08:47:07Z
ModifiedTime	string	任务修改时间，格式为 utc 时间。格式为："YYYY-MM-DD'T'hh:mm:ss'Z'"。	2024-06-13T08:57:07Z
CompleteTime	string	任务完成时间，格式为 utc 时间。格式为："YYYY-MM-DD'T'hh:mm:ss'Z'"。	2024-06-13T08:57:07Z
SubJobList	array<object>	一键成片子任务列表
SubJobList	object	一键成片子任务信息
MediaId	string	成片媒资 ID。	**1470b11171ee9d19e7e6c66a**
JobId	string	子任务 ID。	**8e81933d44e3ae69e2f81485**
MediaURL	string	输出成片的文件地址	http:/xxx.oss-cn-shanghai.aliyuncs.com/xxx_0.mp4
Status	string	子任务状态。取值范围： Init：初始化 Processing：处理中 Success：成功 Failed：失败	Success
ErrorCode	string	失败时错误码。如果执行成功则不返回此参数。	InvalidMaterial.NotFound
ErrorMessage	string	失败时错误信息。如成功则不返回此参数。	The specified clips id not found:["**30d0b5e871eebb2ff7f6c75a**"]
ProjectId	string	云剪辑工程 ID。	**7cc47fe04eaa81bd853acb6a**

示例

正常返回示例

JSON格式

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "EditingBatchJob": {
    "JobId": "****b6b2750d4308892ac3330238****",
    "InputConfig": "{\n  \"MediaGroupArray\": [{\n      \"GroupName\": \"MediaGroup1\",\n      \"MediaArray\": [\n        \"****9d46c886b45481030f6e****\",\n        \"****6c886b4549d481030f6e****\" ]\n    }, {\n      \"GroupName\": \"MediaGroup2\",\n      \"MediaArray\": [\n        \"****d46c886810b454930f6e****\",\n        \"****4549d886810b46c30f6e****\" ]\n  }],\n  \"TitleArray\": [\n      \"回龙观盒马鲜生开业啦\",\n      \"盒马鲜生开业啦\" ],\n  \"SpeechTextArray\": [\n      \"附近的商场新开了一家盒马鲜生，今天是第一天开业\"\n      \"商场里的人不少，零食、酒水都比较便宜大家也快来看看呀\" ]\n}",
    "EditingConfig": "{\n  \"MediaConfig\": {\n      \"Volume\": 0\n  },\n  \"SpeechConfig\": {\n      \"Volume\": 1\n  },\n \"BackgroundMusicConfig\": {\n      \"Volume\": 0.3\n  }\n}",
    "OutputConfig": "{\n  \"MediaURL\": \"http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4\",\n  \"Count\": 20,\n  \"MaxDuration\": 15,\n  \"Width\": 1080,\n  \"Height\": 1920,\n  \"Video\": {\"Crf\": 27}\n}",
    "Status": "Finished",
    "UserData": "{\"NotifyAddress\":\"http://xx.xx.xxx\"}",
    "Extend": "{\n\t\"ErrorCode\": \"InvalidMaterial.NotFound\",\n\t\"ErrorMessage\": \"The specified clips id not found:[\\\"****30d0b5e871eebb2ff7f6c75a****\\\"]\"\n}",
    "CreateTime": "2024-06-13T08:47:07Z",
    "ModifiedTime": "2024-06-13T08:57:07Z\n",
    "CompleteTime": "2024-06-13T08:57:07Z\n",
    "JobType": "",
    "SubJobList": [
      {
        "MediaId": "****1470b11171ee9d19e7e6c66a****",
        "JobId": "****8e81933d44e3ae69e2f81485****",
        "MediaURL": "http:/xxx.oss-cn-shanghai.aliyuncs.com/xxx_0.mp4",
        "Status": "Success",
        "ErrorCode": "InvalidMaterial.NotFound",
        "ErrorMessage": "The specified clips id not found:[\"****30d0b5e871eebb2ff7f6c75a****\"]",
        "ProjectId": "****7cc47fe04eaa81bd853acb6a****"
      }
    ]
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-07-22	OpenAPI 返回结构发生变更	查看变更详情
2024-07-03	OpenAPI 入参发生变更	查看变更详情
2024-04-28	OpenAPI 返回结构发生变更	查看变更详情