文档

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

更新时间:

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
JobIdstring

批量智能一键成片作业 ID

****b4549d46c88681030f6e****

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID

****36-3C1E-4417-BDB2-1E034F****
EditingBatchJobobject

批量智能一键成片任务信息

JobIdstring

任务 ID

****b6b2750d4308892ac3330238****
InputConfigstring

用户合成输出配置。具体结构定义,请参见 InputConfig 配置说明。

{ "MediaGroupArray": [{ "GroupName": "MediaGroup1", "MediaArray": [ "****9d46c886b45481030f6e****", "****6c886b4549d481030f6e****" ] }, { "GroupName": "MediaGroup2", "MediaArray": [ "****d46c886810b454930f6e****", "****4549d886810b46c30f6e****" ] }], "TitleArray": [ "回龙观盒马鲜生开业啦", "盒马鲜生开业啦" ], "SpeechTextArray": [ "附近的商场新开了一家盒马鲜生,今天是第一天开业" "商场里的人不少,零食、酒水都比较便宜大家也快来看看呀" ] }
EditingConfigstring

剪辑相关配置。具体结构定义,请参见 EditingConfig 配置说明。

{ "MediaConfig": { "Volume": 0 }, "SpeechConfig": { "Volume": 1 }, "BackgroundMusicConfig": { "Volume": 0.3 } }
OutputConfigstring

输出配置。具体结构定义,请参见 OutputConfig 配置说明。

{ "MediaURL": "http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4", "Count": 20, "MaxDuration": 15, "Width": 1080, "Height": 1920, "Video": {"Crf": 27} }
Statusstring

任务状态。取值范围:

- Init:初始化

- Processing:处理中

- Finished: 处理完成

Finished
UserDatastring

用户业务配置、回调配置。具体结构定义,请参见 UserData 配置说明。

{"NotifyAddress":"http://xx.xx.xxx"}
Extendstring

扩展信息。字段详情:

- ErrorCode: 主任务错误码

- ErrorMessage: 主任务错误信息

{ "ErrorCode": "InvalidMaterial.NotFound", "ErrorMessage": "The specified clips id not found:[\"****30d0b5e871eebb2ff7f6c75a****\"]" }
SubJobListobject []

一键成片子任务列表

MediaIdstring

成片媒资 ID。

****1470b11171ee9d19e7e6c66a****
JobIdstring

子任务 ID。

****8e81933d44e3ae69e2f81485****
MediaURLstring

输出成片的文件地址

http:/xxx.oss-cn-shanghai.aliyuncs.com/xxx_0.mp4
Statusstring

子任务状态。取值范围:

- Init:初始化

- Processing:处理中

- Success:成功

- Failed: 失败

Success
ErrorCodestring

失败时错误码。如果执行成功则不返回此参数。

InvalidMaterial.NotFound
ErrorMessagestring

失败时错误信息。如成功则不返回此参数。

The specified clips id not found:["****30d0b5e871eebb2ff7f6c75a****"]

示例

正常返回示例

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": "",
    "ModifiedTime": "",
    "CompleteTime": "",
    "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****\"]"
      }
    ]
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-04-28OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
  • 本页导读 (1)