全部產品
Search
文件中心

Intelligent Media Services:GetBatchMediaProducingJob - 擷取批量智能一鍵成片任務資訊

更新時間:Mar 21, 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}"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情