Gunakan SubmitMediaInfoJob untuk menganalisis informasi media - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Mengirimkan pekerjaan analisis informasi media. ApsaraVideo Media Processing (MPS) menganalisis file input dan mengembalikan informasi medianya.

Deskripsi operasi

Pastikan file berhasil diunggah ke OSS sebelum Anda mengirimkan pekerjaan analisis informasi media. Jika tidak, pekerjaan akan gagal. Anda dapat memeriksa status unggahan file dengan mengonfigurasi Paket callback OSS.
Pekerjaan analisis informasi media mendukung mode sinkron dan asinkron.
Mode asinkron tidak menjamin Ketepatan waktu. Setelah pekerjaan analisis informasi media dikirimkan, tugas ditambahkan ke antrian MPS untuk penjadwalan dan eksekusi. Oleh karena itu, pekerjaan mungkin belum dihasilkan saat tanggapan API dikembalikan. Setelah eksekusi selesai, Anda harus memanggil operasi Query media information analysis jobs untuk melakukan polling hasil eksekusi, atau menyambungkan Paket MNS ke antrian MPS untuk menerima hasil eksekusi. Untuk informasi selengkapnya, lihat Menerima Notifikasi Paket.

Batas QPS

Batas kueri per detik (QPS) untuk satu pengguna adalah 50. Jika batas terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat. Untuk informasi selengkapnya, lihat QPS limits.

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

mts:SubmitMediaInfoJob

create

*Semua resource.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Input	string	Yes	Input pekerjaan. Untuk informasi selengkapnya, lihat Input details. Catatan Dalam operasi API ApsaraVideo Media Processing, parameter Object harus di-URL-encoded berdasarkan UTF-8 sebelum digunakan. Wilayah OSS harus sama dengan wilayah MPS.	{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}
UserData	string	No	Data pengguna kustom. Nilai dapat berisi huruf, angka, dan tanda hubung (-), serta tidak boleh diawali dengan karakter khusus. Panjang maksimum adalah 1.024 byte.	testid-001
PipelineId	string	No	ID antrian MPS. Untuk informasi selengkapnya, lihat Terms. Nilai valid: Anda dapat mengkueri dan membuat antrian MPS dengan memilih Pengaturan Global > Antrian MPS di Konsol MPS. Jika notifikasi asinkron diperlukan, sambungkan Paket MNS ke antrian MPS. Untuk informasi selengkapnya, lihat Menerima Notifikasi Paket.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	No	Apakah akan mengirimkan pekerjaan asinkron. Nilai valid: true: Mengirimkan pekerjaan asinkron. Nilai ini direkomendasikan. false: Tidak mengirimkan pekerjaan asinkron.	true
Config	string	No

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
MediaInfoJob	object	Detail pekerjaan analisis informasi media.
CreationTime	string	Pengatur waktu saat pekerjaan ditambahkan. Pengatur waktu ditampilkan dalam UTC dan mengikuti standar ISO 8601 dalam format YYYY-MM-DDTHH:mm:ssZ.	2014-01-10T12:00:00Z
State	string	Status pekerjaan. Nilai valid: Success: Pekerjaan berhasil. Fail: Pekerjaan gagal. Analyzing: Pekerjaan sedang dianalisis.	Analyzing
JobId	string	ID pekerjaan analisis informasi media.	23ca1d184c0e4341e5b665e2a12****
UserData	string	Data pengguna kustom.	testid-001
Code	string	Kode kesalahan yang dikembalikan ketika analisis informasi media gagal.	InvalidParameter.JsonObjectFormatInvalid
Message	string	Paket kesalahan yang dikembalikan ketika analisis informasi media gagal.	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	ID Antrian MPS.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Apakah pekerjaan bersifat asinkron.	true
Input	object	Informasi input pekerjaan.
Object	string	Objek Object Storage Service (OSS) file input.	example.flv
Location	string	Wilayah bucket OSS yang menyimpan file input.	example-location
Bucket	string	Bucket OSS yang menyimpan file input.	example-bucket
MNSMessageResult	object	Hasil notifikasi Message Service (MNS) yang dikirim ke pengguna setelah pekerjaan selesai.
MessageId	string	ID Paket jika pekerjaan berhasil. Parameter ini tidak dikembalikan jika pekerjaan gagal.	16f01ad6175e4230ac42bb5182cd****
ErrorMessage	string	Paket kesalahan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.	InvalidParameter.JsonObjectFormatInvalid
ErrorCode	string	Kode kesalahan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.	The parameter \"Input\" does not conform to the JSON Object specification
Properties	object	Properti file media.
Width	string	Lebar video. Unit: piksel.	1920
Height	string	Tinggi video. Unit: piksel.	1080
Duration	string	Durasi total. Unit: detik.	17.226000
Fps	string	Laju frame.	25
Bitrate	string	Bitrate. Unit: Kbps.	1630.045
FileFormat	string	Format file.	QuickTime/MOV
Streams	object	Informasi aliran.
VideoStreamList	object
VideoStream	array<object>	Daftar aliran video. Daftar ini berisi hingga empat elemen.
	array<object>	Aliran video.
Sar	string	Rasio aspek sampel.	1:1
Height	string	Tinggi video. Unit: piksel.	1080
CodecTagString	string	Teks penanda format encoding.	avc1
NetworkCost	object	Konsumsi lebar pita jaringan.
PreloadTime	string	Pengatur waktu pemuatan awal.	8
AvgBitrate	string	Bitrate rata-rata. Unit: Kbps.	300.34
CostBandwidth	string	Bandwidth maksimum yang dikonsumsi.	10
Width	string	Lebar video. Unit: piksel.	1920
Index	string	Indeks aliran video. Indeks ini mengidentifikasi posisi aliran video dalam seluruh aliran media. Beberapa platform pemutaran memungkinkan Anda menentukan indeks aliran video untuk memulai pemutaran, sementara yang lain memulai pemutaran dari indeks 1 secara default.	1
Timebase	string	Basis pengatur waktu.	1/24000
AvgFPS	string	Laju frame rata-rata.	23.976025
PixFmt	string	Format piksel.	yuv420p
Lang	string	Bahasa.	eng
CodecLongName	string	Nama panjang format encoding.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	Jumlah total frame.	100
Rotate	string	Sudut rotasi video.	90
Bitrate	string	Bitrate. Unit: Kbps.	1496.46
HasBFrames	string	Apakah video berisi B-frame. Nilai 0 menunjukkan tidak ada B-frame. Nilai 1 menunjukkan bahwa B-frame disertakan.	0
Profile	string	Profil pengkodean.	High
StartTime	string	Pengatur waktu mulai.	0.042000
Dar	string	Rasio aspek tampilan. Rasio aspek tampilan dihitung dengan membagi lebar video dengan tinggi video. Anda dapat menggunakan nilai ini untuk menentukan apakah video berorientasi lanskap atau potret.	16:9
CodecName	string	Nama pendek format encoding. Nilai valid: h264 h265 gif webp	h264
Duration	string	Durasi. Unit: detik.	17.225542
Fps	string	Laju frame.	25
CodecTag	string	Penanda format encoding.	0x31637661
CodecTimeBase	string	Basis pengatur waktu kodek.	1001/48000
Level	string	Tingkat encoding.	41
ColorRange	string	Rentang warna.	700
ColorTransfer	string	Karakteristik transfer warna.	R255 G83 B170
ColorPrimaries	string	Warna primer.	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	Daftar aliran audio. Daftar ini berisi hingga empat elemen.
	object	Aliran video.
Timebase	string	Basis pengatur waktu.	1/44100
Index	string	Indeks aliran audio. Indeks ini mengidentifikasi posisi aliran audio dalam seluruh aliran media.	1
SampleFmt	string	Format sampel.	fltp
ChannelLayout	string	Tata letak saluran.	stereo
Lang	string	Bahasa.	eng
Samplerate	string	Laju pengambilan sampel. Unit: Hz.	44100
CodecLongName	string	Nama panjang format encoding.	AAC (Advanced Audio Coding)
Channels	string	Jumlah saluran.	2
NumFrames	string	Jumlah total frame.	123
Bitrate	string	Bitrate. Unit: Kbps.	128.806
CodecTagString	string	Teks penanda format encoding.	mp4a
StartTime	string	Pengatur waktu mulai.	0.000000
CodecName	string	Nama pendek format encoding. Nilai default: acc. Nilai valid: acc mp3 mp4 ogg flac	aac
Duration	string	Durasi. Unit: detik.	17.159546
CodecTag	string	Penanda format encoding.	0x6134706d
CodecTimeBase	string	Basis pengatur waktu kodek.	1/44100
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	Daftar aliran subtitle. Daftar ini berisi hingga empat elemen.
	object	Aliran video.
Timebase	string	Basis pengatur waktu.	1/1000
Index	string	Indeks aliran subtitle. Indeks ini mengidentifikasi posisi aliran subtitle dalam seluruh aliran media.	3
StartTime	string	Waktu mulai.	0.000000
CodecName	string	Nama singkat format encoding. Nilai valid: srt ass	ass
Lang	string	Bahasa.	eng
CodecLongName	string	Nama panjang format encoding.	ASS (Advanced SSA) subtitle
Duration	string	Durasi. Unit: detik.	1370.116000
CodecTag	string	Tag format encoding.	0x0000
CodecTimeBase	string	Basis waktu kodek.	0/1
CodecTagString	string	String tag format encoding.	[0][0][0][0]
Format	object	Informasi format.
StartTime	string	Waktu mulai.	0.000000
NumPrograms	string	Jumlah total aliran program.	0
Size	string	Ukuran file, dalam byte.	3509895
NumStreams	string	Jumlah total aliran media.	2
FormatLongName	string	Nama panjang format kontainer atau pengemasan.	QuickTime/MOV
Duration	string	Durasi total. Unit: detik.	17.226000
Bitrate	string	Total bitrate, dalam Kbit/s.	1630.045
FormatName	string	Nama singkat format kontainer atau pengemasan. Untuk informasi selengkapnya, lihat Detail parameter.	mov
Tags	object
FileSize	string	Ukuran file, dalam byte.	3509895
MD5	string
RequestId	string	ID permintaan.	62D9BE16-B7D5-550C-A482-7A0F60E09877

Contoh

Respons sukses

JSONformat

{
  "MediaInfoJob": {
    "CreationTime": "2014-01-10T12:00:00Z",
    "State": "Analyzing",
    "JobId": "23ca1d184c0e4341e5b665e2a12****",
    "UserData": "testid-001",
    "Code": "InvalidParameter.JsonObjectFormatInvalid",
    "Message": "The parameter ”*” does not conform to the JSON Object specification",
    "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
    "Async": true,
    "Input": {
      "Object": "example.flv",
      "Location": "example-location",
      "Bucket": "example-bucket"
    },
    "MNSMessageResult": {
      "MessageId": "16f01ad6175e4230ac42bb5182cd****",
      "ErrorMessage": "InvalidParameter.JsonObjectFormatInvalid",
      "ErrorCode": "The parameter \\\"Input\\\" does not conform to the JSON Object specification"
    },
    "Properties": {
      "Width": "1920",
      "Height": "1080",
      "Duration": "17.226000",
      "Fps": "25",
      "Bitrate": "1630.045",
      "FileFormat": "QuickTime/MOV",
      "Streams": {
        "VideoStreamList": {
          "VideoStream": [
            {
              "Sar": "1:1",
              "Height": "1080",
              "CodecTagString": "avc1",
              "NetworkCost": {
                "PreloadTime": "8",
                "AvgBitrate": "300.34",
                "CostBandwidth": "10"
              },
              "Width": "1920",
              "Index": "1",
              "Timebase": "1/24000",
              "AvgFPS": "23.976025",
              "PixFmt": "yuv420p",
              "Lang": "eng",
              "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
              "NumFrames": "100",
              "Rotate": "90",
              "Bitrate": "1496.46",
              "HasBFrames": "0",
              "Profile": "High",
              "StartTime": "0.042000",
              "Dar": "16:9",
              "CodecName": "h264",
              "Duration": "17.225542",
              "Fps": "25",
              "CodecTag": "0x31637661",
              "CodecTimeBase": "1001/48000",
              "Level": "41",
              "ColorRange": "700",
              "ColorTransfer": "R255 G83 B170",
              "ColorPrimaries": "700",
              "DurationInaccurate": "",
              "DolbyVision": {
                "Profile": "",
                "Level": ""
              }
            }
          ]
        },
        "AudioStreamList": {
          "AudioStream": [
            {
              "Timebase": "1/44100",
              "Index": "1",
              "SampleFmt": "fltp",
              "ChannelLayout": "stereo",
              "Lang": "eng",
              "Samplerate": "44100",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "Channels": "2",
              "NumFrames": "123",
              "Bitrate": "128.806",
              "CodecTagString": "mp4a",
              "StartTime": "0.000000",
              "CodecName": "aac",
              "Duration": "17.159546",
              "CodecTag": "0x6134706d",
              "CodecTimeBase": "1/44100",
              "DurationInaccurate": ""
            }
          ]
        },
        "SubtitleStreamList": {
          "SubtitleStream": [
            {
              "Timebase": "1/1000",
              "Index": "3",
              "StartTime": "0.000000",
              "CodecName": "ass",
              "Lang": "eng",
              "CodecLongName": "ASS (Advanced SSA) subtitle",
              "Duration": "1370.116000",
              "CodecTag": "0x0000",
              "CodecTimeBase": "0/1",
              "CodecTagString": "[0][0][0][0]"
            }
          ]
        }
      },
      "Format": {
        "StartTime": "0.000000",
        "NumPrograms": "0",
        "Size": "3509895",
        "NumStreams": "2",
        "FormatLongName": "QuickTime/MOV",
        "Duration": "17.226000",
        "Bitrate": "1630.045",
        "FormatName": "mov",
        "Tags": {
          "test": "test",
          "test2": 1
        }
      },
      "FileSize": "3509895",
      "MD5": ""
    }
  },
  "RequestId": "62D9BE16-B7D5-550C-A482-7A0F60E09877"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.