All Products
Search
Document Center

:SubmitMediaInfoJob

Last Updated:May 27, 2026

Mengirimkan pekerjaan analisis informasi media.

Deskripsi

Setelah Anda memanggil operasi SubmitMediaInfoJob, ApsaraVideo Media Processing (MPS) menganalisis file media input dan menghasilkan hasil analisis tersebut. Anda dapat memanggil operasi QueryMediaInfoJobList untuk menanyakan hasil analisis tersebut.

Catatan Kami menyarankan agar Anda mengirimkan pekerjaan analisis informasi media setelah memastikan bahwa file media telah diunggah ke Object Storage Service (OSS). Anda dapat mengonfigurasi upload callbacks untuk menerima notifikasi mengenai status unggahan file.

Batas QPS

Anda dapat memanggil operasi ini hingga 50 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter Tipe Wajib Contoh Deskripsi
Action String Ya SubmitMediaInfoJob

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SubmitMediaInfoJob.

Input String Ya {"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}

Informasi mengenai file media input. Nilainya berupa string JSON. Anda harus melakukan langkah-langkah berikut untuk memberikan izin kepada MPS agar dapat mengakses bucket OSS tempat file media input disimpan: Login ke MPS console, pilih Workflows > Media Buckets pada panel navigasi sebelah kiri, lalu klik Add Bucket. Setelah itu, Anda harus melakukan URL-encode terhadap objek tersebut. Misalnya, {"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"} merepresentasikan file example-bucket.example-location.aliyuncs.com/example/example.flv.

Catatan Bucket OSS harus berada di wilayah tempat Anda menggunakan MPS.
UserData String Tidak testid-001

Data kustom. Data kustom dapat berisi huruf, angka, dan tanda hubung (-), serta panjangnya maksimal 1.024 byte. Data tidak boleh diawali dengan tanda hubung (-).

PipelineId String Tidak 88c6ca184c0e432bbf5b665e2a15****

ID Antrian MPS tempat pekerjaan analisis dikirimkan. Untuk melihat ID Antrian MPS, login ke MPS console dan pilih Global Settings > Pipelines pada panel navigasi sebelah kiri.

Async Boolean Tidak true

Menentukan apakah mode asinkron diaktifkan untuk pekerjaan ini. Kami menyarankan agar Anda menetapkan parameter ini ke true. Nilai yang valid:

  • true: mengaktifkan mode asinkron.
  • false: tidak mengaktifkan mode asinkron.

Parameter respons

Parameter Tipe Contoh Deskripsi
MediaInfoJob Object

Detail pekerjaan analisis informasi media.

CreationTime String 2014-01-10T12:00:00Z

Waktu saat pekerjaan dibuat.

State String Analyzing

Status pekerjaan. Nilai yang valid:

  • Success: Pekerjaan berhasil.
  • Fail: Pekerjaan gagal.
  • Analyzing: Pekerjaan sedang dijalankan.
JobId String 23ca1d184c0e4341e5b665e2a12****

ID pekerjaan.

UserData String testid-001

Data kustom.

Code String InvalidParameter.JsonObjectFormatInvalid

Kode kesalahan yang dikembalikan jika pekerjaan gagal.

Message String The parameter "*" does not conform to the JSON Object specification

Pesan kesalahan yang dikembalikan jika pekerjaan gagal.

PipelineId String 88c6ca184c0e432bbf5b665e2a15****

ID Antrian MPS tempat pekerjaan analisis dikirimkan.

Async Boolean true

Menunjukkan apakah pekerjaan dijalankan dalam mode asinkron.

Input Object

Informasi mengenai file media input.

Object String example.flv

Nama objek OSS yang digunakan sebagai file media input.

Location String example-location

Wilayah bucket OSS tempat file media input disimpan.

Bucket String example-bucket

Nama bucket OSS tempat file media input disimpan.

MNSMessageResult Object

Detail pesan yang dikirim ke Message Service (MNS) untuk memberi tahu pengguna mengenai hasil pekerjaan.

MessageId String 16f01ad6175e4230ac42bb5182cd****

ID pesan yang dikembalikan jika pekerjaan berhasil. Parameter ini tidak dikembalikan jika pekerjaan gagal.

ErrorMessage String InvalidParameter.JsonObjectFormatInvalid

Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

ErrorCode String The parameter \"Input\" does not conform to the JSON Object specification

Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.

Properties Object

Properti file media input.

Width String 1920

Lebar video. Satuan: piksel.

Height String 1080

Tinggi video. Satuan: piksel.

Duration String 17.226000

Durasi total file media input. Satuan: detik.

Fps String 25

Laju frame.

Bitrate String 1630.045

Bitrate. Satuan: Kbit/s.

FileFormat String QuickTime/MOV

Format file media input.

Streams Object

Aliran media yang terdapat dalam file media input.

VideoStreamList Array of VideoStream

Aliran video. Sebuah file media dapat berisi hingga empat aliran video.

VideoStream
Sar String 1:1

Rasio aspek sampel (SAR).

Height String 1080

Tinggi video. Satuan: piksel.

CodecTagString String avc1

String tag format encoding.

NetworkCost Object

Lebar pita jaringan yang dikonsumsi.

PreloadTime String 8

Waktu yang dikonsumsi untuk preload video.

AvgBitrate String 300.34

Rata-rata bitrate. Satuan: Kbit/s.

CostBandwidth String 10

Lebar pita maksimum yang dikonsumsi.

Width String 1920

Lebar video. Satuan: piksel.

Index String 1

Nomor urut aliran video. Nilai ini menunjukkan posisi aliran video di antara semua aliran video. Nomor urut aliran video pertama yang diputar dapat ditentukan di beberapa pemutar. Nilai default: 1.

Timebase String 1/24000

Dasar waktu.

AvgFPS String 23.976025

Rata-rata laju frame.

PixFmt String yuv420p

Format piksel.

Lang String eng

Bahasa.

CodecLongName String H.264/AVC/MPEG-4 AVC/MPEG-4 part 10

Nama lengkap format encoding.

NumFrames String 100

Jumlah total frame.

Rotate String 90

Sudut rotasi video.

Bitrate String 1496.46

Bitrate. Satuan: Kbit/s.

HasBFrames String 0

Menunjukkan apakah aliran video berisi frame bidireksional (B-frame). Nilai 1 berarti aliran video berisi B-frame. Nilai 0 berarti aliran video tidak berisi B-frame.

Profile String High

Profil codec.

StartTime String 0.042000

Waktu mulai.

Dar String 16:9

Rasio aspek tampilan (DAR). DAR adalah hubungan proporsional antara lebar dan tinggi video. Nilai ini digunakan untuk menentukan apakah video berada dalam mode potret atau lanskap.

CodecName String h264

Nama singkat format encoding. Nilai yang valid:

  • h264
  • h265
  • gif
  • webp
Duration String 17.225542

Durasi. Satuan: detik.

Fps String 25

Laju frame.

CodecTag String 0x31637661

Tag format encoding.

CodecTimeBase String 1001/48000

Dasar waktu codec.

Level String 41

Tingkat codec.

ColorRange String 700

Rentang warna.

ColorTransfer String R255 G83 B170

Saluran warna.

ColorPrimaries String 700

Tingkat rekonstruksi warna.

AudioStreamList Array of AudioStream

Aliran audio. Sebuah file media dapat berisi hingga empat aliran audio.

AudioStream
Timebase String 1/44100

Dasar waktu.

Index String 1

Nomor urut aliran audio. Nilai ini menunjukkan posisi aliran audio di antara semua aliran audio.

SampleFmt String fltp

Format pengambilan sampel.

ChannelLayout String stereo

Tata letak output saluran suara.

Lang String eng

Bahasa.

Samplerate String 44100

Laju pengambilan sampel. Satuan: Hz.

CodecLongName String AAC (Advanced Audio Coding)

Nama lengkap format encoding.

Channels String 2

Jumlah saluran suara.

NumFrames String 123

Jumlah total frame.

Bitrate String 128.806

Bitrate. Satuan: Kbit/s.

CodecTagString String mp4a

String tag dari format encoding.

StartTime String 0.000000

Waktu mulai.

CodecName String aac

Nama singkat format encoding. Nilai default: acc. Nilai yang valid:

  • acc
  • mp3
  • mp4
  • ogg
  • flac
Duration String 17.159546

Durasi. Satuan: detik.

CodecTag String 0x6134706d

Tag format encoding.

CodecTimeBase String 1/44100

Dasar waktu codec.

SubtitleStreamList Array of SubtitleStream

Aliran subtitle. Sebuah file media dapat berisi hingga empat aliran subtitle.

SubtitleStream
Timebase String 1/1000

Dasar waktu.

Index String 3

Nomor urut aliran subtitle. Nilai ini menunjukkan posisi aliran subtitle di antara semua aliran subtitle.

StartTime String 0.000000

Waktu mulai.

CodecName String ass

Nama singkat format encoding. Nilai yang valid:

  • srt
  • ass
Lang String eng

Bahasa.

CodecLongName String ASS (Advanced SSA) subtitle

Nama lengkap format encoding.

Duration String 1370.116000

Durasi. Satuan: detik.

CodecTag String 0x0000

Tag format encoding.

CodecTimeBase String 0/1

Dasar waktu codec.

CodecTagString String [0][0][0][0]

String tag dari format encoding.

Format Object

Informasi format.

StartTime String 0.000000

Waktu mulai.

NumPrograms String 0

Jumlah total aliran program.

Size String 3509895

Ukuran file. Satuan: byte.

NumStreams String 2

Jumlah total aliran media.

FormatLongName String QuickTime/MOV

Nama lengkap format kontainer.

Duration String 17.226000

Durasi total file media input. Satuan: detik.

Bitrate String 1630.045

Total bitrate. Satuan: Kbit/s.

FormatName String mov

Nama singkat format kontainer. Untuk informasi lebih lanjut mengenai parameter, lihat Detail parameter.

FileSize String 3509895

Ukuran file. Satuan: byte.

RequestId String 62D9BE16-B7D5-550C-A482-7A0F60E09877

ID permintaan.

Catatan Jika terjadi kesalahan permintaan, periksa apakah file media input valid. Jika file tersebut valid tetapi masalah masih berlanjut, kirim tiket untuk menghubungi layanan pelanggan Alibaba Cloud.

Contoh

Contoh permintaan

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaInfoJob
&ResourceOwnerId=1
&Input={"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}
&UserData=testid-001
&PipelineId=88c6ca184c0e432bbf5b665e2a15****
&Async=true
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
    "MediaInfoJob": {
        "CreationTime": "2014-01-10T12:00:00Z",
        "State": "Analyzing",
        "JobId": "23ca1d184c0e4341e5b665e2a12****",
        "UserData": "testid-001",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
            "Object": "example.flv",
            "Location": "example-location",
            "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
            "MessageId": "16f01ad6175e4230ac42bb5182cd****",
        },
        "Properties": {
            "Width": "1920",
            "Height": "1080",
            "Duration": "17.226000",
            "Fps": "25",
            "Bitrate": "1630.045",
            "FileFormat": "QuickTime/MOV",
            "Streams": {
                "VideoStreamList": [
                    {
                        "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"
                    }
                ],
                "AudioStreamList": [
                    {
                        "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"
                    }
                ],
                "SubtitleStreamList": [
                    {
                        "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"
            },
            "FileSize": "3509895"
        }
    },
    "RequestId": "62D9BE16-B7D5-550C-A482-7A0F60E09877"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.