使用 ICE API 自动化场景时间线作业 - ICE -Alibaba Cloud - 智能媒体服务

接口说明

提交场景化时间线编排任务后，您可以调用 ListBatchMediaProducingJob 获取所有符合条件的任务列表。调用 GetBatchMediaProducingJob 获取任务详细信息，包括任务的状态、合成的媒资 ID 及 URL 等。
公测中，暂不收费。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

ice:SubmitSceneTimelineOrganizationJob

none

*全部资源

*

无

请求语法

GET  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
InputConfig	string	是	输入配置，和一键成片图文匹配/高燃混剪能力的 InputConfig 参数一致。 JobType = Smart_Mix_Timeline_Organize 时，详见图文匹配参数配置 JobType = Screen_Media_Highlights_Timeline_Organize 时，详见高燃混剪参数配置	{ "BackgroundMusic": "**75c3936f3a8743850f2da942**", "MediaArray": [ "https://test-bucket.oss-cn-shanghai.aliyuncs.com/test.mp4" ], "SpeechTextArray": [ "附近的商场新开了一家盒马鲜生，今天是第一天开业" ] }
EditingConfig	string	否	剪辑配置。和一键成片图文匹配/高燃混剪能力的 EditingConfig 参数一致。 JobType = Smart_Mix_Timeline_Organize 时，详见图文匹配参数配置 JobType = Screen_Media_Highlights_Timeline_Organize 时，详见高燃混剪参数配置	{ "MediaConfig": { "Volume": 0 }, "SpeechConfig": { "Volume": 1 }, "BackgroundMusicConfig": { "Volume": 0.3 } }
OutputConfig	string	是	输出配置，和一键成片图文匹配/高燃混剪能力的 OutputConfig 参数一致。 JobType = Smart_Mix_Timeline_Organize 时，详见图文匹配参数配置 JobType = Screen_Media_Highlights_Timeline_Organize 时，详见高燃混剪参数配置	{ "MediaURL": "http://test-bucket.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4", "Count": 1, "Width": 1080, "Height": 1920 }
UserData	string	否	用户业务配置、回调配置。具体结构定义，请参见 UserData 配置说明。	{"NotifyAddress":"http://xx.xx.xxx"}或{"NotifyAddress":"https://xx.xx.xxx"}或{"NotifyAddress":"ice-callback-demo"}
JobType	string	是	任务类型，取值： Smart_Mix_Timeline_Organize：智能匹配时间线编排 Screen_Media_Highlights_Timeline_Organize：高燃混剪时间线编排两种场景区别在于：智能匹配：针对智能匹配场景的素材挑选结果（口播文案和素材的匹配结果），自动编排一个或多个成片的时间线，多适用于批量营销、通用混剪场景。高燃混剪：针对高燃混剪场景的素材挑选结果（高燃片段的挑选结果）自动编排一个或多个成片的时间线，多适用于短剧高燃混剪场景。	Smart_Mix_Timeline_Organize
MediaSelectResult	string	是	素材挑选结果。可调用 SubmitSceneMediaSelectionJob 提交素材挑选任务，并通过 GetBatchMediaProducingJob 获取挑选结果。	{ "textMatchMediaOutputList": [{ "textMatchMediaSentenceOutputList": [{ "duration": 3.366667, "matchClipList": [{ "endTime": 11.16, "mediaId": "**a0900f5071efbf1ce7e6c66a", "startTime": 8.04 }], "text": "附近的商场新开了一家盒马鲜生" }, { "duration": 1.566667, "matchClipList": [{ "endTime": 1.54, "mediaId": "a0900f5071efbf1ce7e6c66a**", "startTime": 0 }], "text": "今天是第一天开业" } ] }] }

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
JobId	string	任务 ID	**20b48fb04483915d4f2cd8ac**

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

错误码

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

变更历史

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