GetBatchMediaProducingJob を呼び出してクイック動画制作タスクをクエリ - IMS

バッチ型 Intelligent One-Click Video Editing ジョブの詳細情報を取得します。入力パラメーター、ジョブステータス、生成されたメディアアセットの ID および URL が含まれます。この API は過去 1 年間のジョブデータのみをクエリできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:GetBatchMediaProducingJob

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
JobId	string	任意	高速ビデオ制作ジョブの ID です。	**b4549d46c88681030f6e**

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーターです。
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	ジョブ作成時刻です。ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で、協定世界時 (UTC) で表示されます。	2024-06-13T08:47:07Z
ModifiedTime	string	ジョブ最終更新時刻です。 ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で、協定世界時 (UTC) で表示されます。	2024-06-13T08:57:07Z
CompleteTime	string	ジョブ完了時刻です。 ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で、協定世界時 (UTC) で表示されます。	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	出力ファイルの URL です。	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	出力ビデオの持続時間（秒）です。	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" } ] }] }

例

成功レスポンス

JSONJSON

{
  "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}"
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。