全部产品
Search
文档中心

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

更新时间:Aug 28, 2026

获取批量智能一键成片作业的详细信息,包括作业的输入参数、任务状态、合成的媒资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

JobType

string

任务类型:

  • Script(脚本化自动成片)

  • Smart_Mix(智能图文匹配成片)

  • Sports_Highlights(体育赛事集锦成片)

  • Screen_Media_Highlights(高燃混剪成片)

  • Smart_Mix_Media_Select(智能匹配--素材挑选)

  • Smart_Mix_Timeline_Organize(智能匹配--时间线编排)

  • Screen_Media_Highlights_Media_Select(高燃混剪--素材挑选)

  • Screen_Media_Highlights_Timeline_Organize(高燃混剪--时间线编排)

  • Scene_Batch_Editing(多时间线批量合成)

Script

SubJobList

array<object>

一键成片子任务列表

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****

Duration

number

成片时长,单位:秒(s)。

24.5

ExtendInput

string

额外输入。

  • JobType = Smart_Mix_Timeline_Organize 或 Screen_Media_Highlights_Timeline_Organize 时,额外输入为素材挑选结果。

  • JobType = Scene_Batch_Editing 时,额外输入为剪辑工程 id 列表。

["****7cc47fe04eaa81bd853acb6a****", "****04eaa7cc47fe81bd853acb6a****"]

ExtendOutput

string

额外输出。

  • JobType = Smart_Mix_Media_Select 或 Screen_Media_Highlights_Media_Select 时,额外返回素材挑选结果。

{ "textMatchMediaOutputList": [{ "textMatchMediaSentenceOutputList": [{ "duration": 3.366667, "matchClipList": [{ "clipId": "null-2", "endTime": 11.16, "mediaId": "****a0900f5071efbf1ce7e6c66a****", "score": -0.253, "startTime": 8.04 }], "text": "附近的商场新开了一家盒马鲜生", "textId": "0" }, { "duration": 1.566667, "matchClipList": [{ "clipId": "null-1", "endTime": 1.54, "mediaId": "****a0900f5071efbf1ce7e6c66a****", "score": -0.2326, "startTime": 0 }], "text": "今天是第一天开业", "textId": "0" } ] }] }

示例

正常返回示例

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": "Script",
    "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****",
        "Duration": 24.5
      }
    ],
    "ExtendInput": "[\"****7cc47fe04eaa81bd853acb6a****\", \"****04eaa7cc47fe81bd853acb6a****\"]",
    "ExtendOutput": "{\n\t\"textMatchMediaOutputList\": [{\n\t\t\"textMatchMediaSentenceOutputList\": [{\n\t\t\t\t\"duration\": 3.366667,\n\t\t\t\t\"matchClipList\": [{\n\t\t\t\t\t\"clipId\": \"null-2\",\n\t\t\t\t\t\"endTime\": 11.16,\n\t\t\t\t\t\"mediaId\": \"****a0900f5071efbf1ce7e6c66a****\",\n\t\t\t\t\t\"score\": -0.253,\n\t\t\t\t\t\"startTime\": 8.04\n\t\t\t\t}],\n\t\t\t\t\"text\": \"附近的商场新开了一家盒马鲜生\",\n\t\t\t\t\"textId\": \"0\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"duration\": 1.566667,\n\t\t\t\t\"matchClipList\": [{\n\t\t\t\t\t\"clipId\": \"null-1\",\n\t\t\t\t\t\"endTime\": 1.54,\n\t\t\t\t\t\"mediaId\": \"****a0900f5071efbf1ce7e6c66a****\",\n\t\t\t\t\t\"score\": -0.2326,\n\t\t\t\t\t\"startTime\": 0\n\t\t\t\t}],\n\t\t\t\t\"text\": \"今天是第一天开业\",\n\t\t\t\t\"textId\": \"0\"\n\t\t\t}\n\t\t]\n\t}]\n}"
  }
}

错误码

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

变更历史

更多信息,参考变更详情