Panggil GetBatchMediaProducingJob untuk kueri pekerjaan produksi video cepat - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Mengambil informasi detail tentang tugas produksi video satu klik cerdas batch, termasuk parameter input tugas, status tugas, dan ID serta URL aset media yang disintesis. API ini hanya mendukung kueri data tugas dari satu tahun terakhir.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ice:GetBatchMediaProducingJob

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
JobId	string	No	ID tugas produksi video satu klik cerdas batch	**b4549d46c88681030f6e**

Elemen respons

Element	Type	Description	Example
	object	Skema Respons
RequestId	string	ID permintaan	**36-3C1E-4417-BDB2-1E034F**
EditingBatchJob	object	Informasi tugas produksi video satu klik cerdas batch
JobId	string	ID tugas	**b6b2750d4308892ac3330238**
InputConfig	string	Konfigurasi output sintesis pengguna. Untuk definisi struktur spesifik, lihat deskripsi konfigurasi InputConfig.	{ "MediaGroupArray": [{ "GroupName": "MediaGroup1", "MediaArray": [ "**9d46c886b45481030f6e", "6c886b4549d481030f6e" ] }, { "GroupName": "MediaGroup2", "MediaArray": [ "d46c886810b454930f6e", "4549d886810b46c30f6e**" ] }], "TitleArray": [ "回龙观盒马鲜生开业啦", "盒马鲜生开业啦" ], "SpeechTextArray": [ "附近的商场新开了一家盒马鲜生，今天是第一天开业" "商场里的人不少，零食、酒水都比较便宜大家也快来看看呀" ] }
EditingConfig	string	Konfigurasi terkait pengeditan. Untuk definisi struktur spesifik, lihat deskripsi konfigurasi EditingConfig.	{ "MediaConfig": { "Volume": 0 }, "SpeechConfig": { "Volume": 1 }, "BackgroundMusicConfig": { "Volume": 0.3 } }
OutputConfig	string	Konfigurasi output. Untuk definisi struktur spesifik, lihat deskripsi konfigurasi 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	Status tugas. Nilai yang valid: Init: Inisialisasi Processing: Sedang diproses Finished: Selesai	Finished
UserData	string	Konfigurasi bisnis pengguna dan konfigurasi callback. Untuk definisi struktur spesifik, lihat deskripsi konfigurasi UserData.	{"NotifyAddress":"http://xx.xx.xxx"}
Extend	string	Informasi tambahan. Detail field: ErrorCode: Kode error tugas utama ErrorMessage: Pesan error tugas utama	{ "ErrorCode": "InvalidMaterial.NotFound", "ErrorMessage": "The specified clips id not found:[\"**30d0b5e871eebb2ff7f6c75a**\"]" }
CreateTime	string	Waktu pembuatan tugas, dalam format waktu UTC	2024-06-13T08:47:07Z
ModifiedTime	string	Waktu modifikasi tugas, dalam format waktu UTC. Format: "YYYY-MM-DD'T'hh:mm:ss'Z'".	2024-06-13T08:57:07Z
CompleteTime	string	Waktu penyelesaian tugas, dalam format waktu UTC. Format: "YYYY-MM-DD'T'hh:mm:ss'Z'".	2024-06-13T08:57:07Z
JobType	string	Jenis tugas: Script (Produksi video otomatis berskenario) Smart_Mix (Produksi video pencocokan gambar-teks cerdas) Sports_Highlights (Produksi video sorotan acara olahraga) Screen_Media_Highlights (Produksi video mixed-cut berenergi tinggi) Smart_Mix_Media_Select (Pencocokan cerdas - pemilihan materi) Smart_Mix_Timeline_Organize (Pencocokan cerdas - pengorganisasian timeline) Screen_Media_Highlights_Media_Select (Mixed-cut berenergi tinggi - pemilihan materi) Screen_Media_Highlights_Timeline_Organize (Mixed-cut berenergi tinggi - pengorganisasian timeline) Scene_Batch_Editing (Sintesis batch multi-timeline)	Script
SubJobList	array<object>	Daftar sub-tugas produksi video satu klik
	object	Informasi sub-tugas produksi video satu klik
MediaId	string	The ID of the output media asset.	**1470b11171ee9d19e7e6c66a**
JobId	string	The subjob ID.	**8e81933d44e3ae69e2f81485**
MediaURL	string	The URL of the output file.	http:/xxx.oss-cn-shanghai.aliyuncs.com/xxx_0.mp4
Status	string	The subjob state. Valid values: Init: The subjob is initialized. Processing: The subjob is in progress. Success: The subjob is successful. Failed: The subjob failed.	Success
ErrorCode	string	The error code that is returned if the subjob failed. This parameter is not returned if the subjob is successful.	InvalidMaterial.NotFound
ErrorMessage	string	The error message that is returned if the subjob failed. This parameter is not returned if the subjob is successful.	The specified clips id not found:["**30d0b5e871eebb2ff7f6c75a**"]
ProjectId	string	The ID of the online editing project.	**7cc47fe04eaa81bd853acb6a**
Duration	number		24.5
ExtendInput	string	Input tambahan. Ketika JobType = Smart_Mix_Timeline_Organize atau Screen_Media_Highlights_Timeline_Organize, input tambahan adalah hasil pemilihan materi. Ketika JobType = Scene_Batch_Editing, input tambahan adalah daftar ID proyek pengeditan.	["**7cc47fe04eaa81bd853acb6a", "04eaa7cc47fe81bd853acb6a**"]
ExtendOutput	string	Output tambahan. Ketika JobType = Smart_Mix_Media_Select atau Screen_Media_Highlights_Media_Select, juga mengembalikan hasil pemilihan materi.	{ "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" } ] }] }

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.