Gunakan SubmitMediaInfoJob untuk menganalisis informasi media - ApsaraVideo Media Processing

Mengirimkan pekerjaan analisis informasi media. Setelah operasi ini dipanggil, ApsaraVideo Media Processing (MPS) menganalisis informasi media dari file input dan mengembalikan hasilnya.

Deskripsi operasi

Pastikan file telah diunggah ke OSS sebelum mengirimkan pekerjaan analisis informasi media. Jika tidak, pekerjaan akan gagal. Anda dapat menggunakan OSS callback messages untuk memverifikasi status unggahan.
Pekerjaan analisis informasi media mendukung mode sinkron dan asinkron.
Mode asinkron tidak menjamin ketepatan waktu. Setelah pekerjaan dikirim, pekerjaan tersebut masuk ke antrian MPS dan menunggu penjadwalan. Pekerjaan mungkin belum dibuat saat API mengembalikan tanggapan. Untuk mengambil hasilnya, Anda dapat melakukan polling terhadap operasi QueryMediaInfoJob atau mengonfigurasi notifikasi pesan MNS untuk antrian MPS. Untuk informasi selengkapnya, lihat dan Receive message notifications.

Batas QPS

Batas maksimum permintaan per detik (QPS) untuk satu pengguna adalah 50. Jika batas ini dilampaui, panggilan API akan dikenai rate-limiting, yang dapat memengaruhi bisnis Anda. Rencanakan panggilan API secara sesuai. 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

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Input	string	Yes	Input pekerjaan. Untuk informasi selengkapnya, lihat Input details. Catatan Dalam API MPS, nilai Object harus di-URL encode menggunakan UTF-8. Wilayah Bucket OSS harus sesuai dengan wilayah tempat MPS dideploy.	{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}
UserData	string	No	Data yang ditentukan pengguna. Anda dapat menggunakan huruf, angka, dan tanda hubung (-). Tidak boleh diawali dengan karakter khusus. Panjang maksimum: 1024 byte.	testid-001
PipelineId	string	No	ID pipeline. Untuk informasi selengkapnya, lihat Terms. Anda dapat menemukan atau membuat pipeline di MPS console>Settings>Pipelines. Untuk menerima notifikasi asinkron, sambungkan Topik MNS ke pipeline. Untuk informasi selengkapnya, lihat dan Receive message notifications.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	No	Tentukan apakah pekerjaan dijalankan secara asinkron. Nilai yang valid: true: Jalankan pekerjaan secara asinkron. Kami merekomendasikan opsi ini. false: Jalankan pekerjaan secara sinkron.	true
Config	string	No

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
MediaInfoJob	object	Informasi detail tentang pekerjaan analisis informasi media.
CreationTime	string	Waktu saat pekerjaan dikirimkan.	2014-01-10T12:00:00Z
State	string	Status pekerjaan. Success: Pekerjaan berhasil. Fail: Pekerjaan gagal. Analyzing: Pekerjaan sedang berjalan.	Analyzing
JobId	string	ID pekerjaan analisis informasi media.	23ca1d184c0e4341e5b665e2a12****
UserData	string	Data yang ditentukan pengguna.	testid-001
Code	string	Kode error jika pekerjaan gagal.	InvalidParameter.JsonObjectFormatInvalid
Message	string	Pesan error jika pekerjaan gagal.	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	ID pipeline.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Apakah pekerjaan dijalankan secara asinkron.	true
Input	object	Informasi input pekerjaan.
Object	string	Objek OSS dari file input.	example.flv
Location	string	Wilayah Bucket OSS.	example-location
Bucket	string	Bucket OSS dari file input.	example-bucket
MNSMessageResult	object	Hasil notifikasi MNS untuk penyelesaian pekerjaan.
MessageId	string	ID pesan jika pekerjaan berhasil. Parameter ini tidak dikembalikan jika pekerjaan gagal.	16f01ad6175e4230ac42bb5182cd****
ErrorMessage	string	Pesan error jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.	InvalidParameter.JsonObjectFormatInvalid
ErrorCode	string	Kode error 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, dalam piksel (px).	1920
Height	string	Tinggi video, dalam piksel (px).	1080
Duration	string	Durasi total, dalam detik (s).	17.226000
Fps	string	Laju frame.	25
Bitrate	string	Bitrate, dalam Kbps.	1630.045
FileFormat	string	Format file.	QuickTime/MOV
Streams	object	Informasi aliran.
VideoStreamList	object
VideoStream	array<object>	Daftar aliran video. Maksimum: 4 item.
	array<object>	Parameter respons.
Sar	string	Rasio aspek sampel.	1:1
Height	string	Tinggi video, dalam piksel (px).	1080
CodecTagString	string	String tag codec.	avc1
NetworkCost	object	Konsumsi bandwidth jaringan.
PreloadTime	string	Waktu preload.	8
AvgBitrate	string	Bitrate rata-rata, dalam Kbps.	300.34
CostBandwidth	string	Konsumsi bandwidth maksimum.	10
Width	string	Lebar video, dalam piksel (px).	1920
Index	string	Indeks aliran video. Mengidentifikasi posisi aliran video dalam file media. Beberapa pemutar memungkinkan Anda menentukan aliran video mana yang akan dimulai pemutaran. Yang lainnya mulai dari indeks 1 secara default.	1
Timebase	string	Basis waktu.	1/24000
AvgFPS	string	Laju frame rata-rata.	23.976025
PixFmt	string	Format piksel.	yuv420p
Lang	string	Bahasa.	eng
CodecLongName	string	Nama panjang codec.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	Jumlah total frame.	100
Rotate	string	Sudut rotasi video, dalam derajat.	90
Bitrate	string	Bitrate, dalam Kbps.	1496.46
HasBFrames	string	Apakah B-frame ada. 0 berarti tidak ada. 1 berarti ada.	0
Profile	string	Profil codec.	High
StartTime	string	Waktu mulai.	0.042000
Dar	string	Rasio aspek tampilan. Dar = lebar video / tinggi video. Gunakan nilai ini untuk menentukan apakah video berorientasi landscape atau portrait.	16:9
CodecName	string	Nama singkat codec. Nilai yang valid: h264 h265 gif webp	h264
Duration	string	Durasi, dalam detik (s).	17.225542
Fps	string	Laju frame.	25
CodecTag	string	Tag codec.	0x31637661
CodecTimeBase	string	Basis waktu codec.	1001/48000
Level	string	Tingkat codec.	41
ColorRange	string	Rentang warna.	700
ColorTransfer	string	Transfer warna.	R255 G83 B170
ColorPrimaries	string	Primer warna.	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	Daftar aliran audio. Maksimum: 4 item.
	object	Parameter respons.
Timebase	string	Basis waktu.	1/44100
Index	string	Indeks aliran audio. Mengidentifikasi posisi aliran audio dalam file media.	1
SampleFmt	string	Format sampel.	fltp
ChannelLayout	string	Tata letak channel.	stereo
Lang	string	Bahasa.	eng
Samplerate	string	Laju sampel, dalam Hz.	44100
CodecLongName	string	Nama panjang codec.	AAC (Advanced Audio Coding)
Channels	string	Jumlah saluran suara.	2
NumFrames	string	Jumlah total frame.	123
Bitrate	string	Bitrate, dalam Kbps.	128.806
CodecTagString	string	String tag codec.	mp4a
StartTime	string	Waktu mulai.	0.000000
CodecName	string	Nama singkat codec. Nilai default: aac. Nilai yang valid: aac mp3 mp4 ogg flac	aac
Duration	string	Durasi, dalam detik (s).	17.159546
CodecTag	string	Tag codec.	0x6134706d
CodecTimeBase	string	Basis waktu codec.	1/44100
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	Daftar aliran subtitle. Maksimum: 4 item.
	object	Parameter respons.
Timebase	string	Basis waktu.	1/1000
Index	string	Indeks aliran subtitle. Mengidentifikasi posisi aliran subtitle dalam file media.	3
StartTime	string	Waktu mulai.	0.000000
CodecName	string	Nama singkat codec. Nilai yang valid: srt ass	ass
Lang	string	Bahasa.	eng
CodecLongName	string	Nama panjang codec.	ASS (Advanced SSA) subtitle
Duration	string	Durasi, dalam detik (s).	1370.116000
CodecTag	string	Tag codec.	0x0000
CodecTimeBase	string	Basis waktu codec.	0/1
CodecTagString	string	String tag codec.	[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 wrapper.	QuickTime/MOV
Duration	string	Durasi total, dalam detik (s).	17.226000
Bitrate	string	Total bitrate, dalam Kbps.	1630.045
FormatName	string	Nama singkat format kontainer atau wrapper. Untuk informasi selengkapnya, lihat Parameter details.	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.