All Products
Search

This Product

    Intelligent Media Services:GetMediaInfo

    Document Center

    Intelligent Media Services:GetMediaInfo

    Last Updated:Aug 06, 2026

    Mengambil informasi aset media berdasarkan MediaId IMS atau InputURL aset media.

    Deskripsi operasi

    Jika MediaId tidak kosong, parameter tersebut akan diprioritaskan. Jika MediaId kosong, InputURL wajib diisi.

    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:GetMediaInfo

    get

    *Semua resource.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    MediaId

    string

    No

    ID aset media IMS. Jika parameter ini kosong, InputURL wajib diisi.

    ****20b48fb04483915d4f2cd8ac****
    InputURL

    string

    No

    Alamat aset media di sistem terkait. Sebelum digunakan, aset media harus didaftarkan di pustaka konten IMS dan dikaitkan dengan mediaId IMS.

    • Alamat OSS. Dukungan dua format:

    http(s)://example-bucket.oss-ap-southeast-1.aliyuncs.com/example.mp4 atau

    oss://example-bucket/example.mp4. Format ini mengasumsikan wilayah OSS sama dengan wilayah akses layanan secara default.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
    OutputType

    string

    No

    Jenis alamat file media dalam respons:

    cdn
    ReturnDetailedInfo

    string

    No

    Menentukan apakah akan mengembalikan informasi detail untuk bidang aset media terkait. Bidang yang didukung: AiRoughData.StandardSmartTagJob: Menentukan apakah akan mengembalikan hasil penandaan detail jika aset media telah diajukan untuk analisis tag.

    • Nilai default: false. Hasil tugas dikembalikan sebagai URL.

    • true: Hasil tugas dikembalikan sebagai teks.

    {"AiRoughData.StandardSmartTagJob": false}

    AuthTimeout

    integer

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons

    RequestId

    string

    ID permintaan.

    2FDE2411-DB8D-4A9A-875B-275798F14A5E
    MediaInfo

    object

    Informasi aset media.

    MediaId

    string

    ID aset media.

    ****20b48fb04483915d4f2cd8ac****
    MediaBasicInfo

    object

    BasicInfo

    MediaId

    string

    ID aset media.

    ****20b48fb04483915d4f2cd8ac****
    InputURL

    string

    URL aset media.

    https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
    MediaType

    string

    Jenis aset media.

    video
    BusinessType

    string

    Jenis bisnis aset media.

    general
    Source

    string

    Sumber aset media.

    oss
    Title

    string

    Judul aset media.

    Title
    Description

    string

    Deskripsi aset media.

    Description
    Category

    string

    Kategori aset media.

    Category
    MediaTags

    string

    Daftar tag aset media yang dipisahkan koma.

    tag1
    CoverURL

    string

    URL gambar sampul.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
    UserData

    string

    Data pengguna kustom.

    userDataTest
    Snapshots

    string

    Daftar URL snapshot.

    [ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=",   "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
    Status

    string

    Status aset media.

    Normal
    CreateTime

    string

    Waktu pembuatan aset media. Waktu dalam UTC dan mengikuti format YYYY-MM-DDTHH:MM:SSZ.

    2020-12-26T04:11:08Z
    ModifiedTime

    string

    Waktu modifikasi terakhir aset media. Waktu dalam UTC dan mengikuti format YYYY-MM-DDTHH:MM:SSZ.

    2020-12-26T04:11:10Z
    DeletedTime

    string

    Waktu penghapusan aset media. Waktu dalam UTC dan mengikuti format YYYY-MM-DDTHH:MM:SSZ.

    2020-12-26T04:11:15Z
    SpriteImages

    string

    Detail gambar sprite yang dihasilkan.

    [{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}]
    CateId

    integer

    ID kategori.

    3048
    Biz

    string

    Bisnis yang terkait dengan aset media.

    ICE
    UploadSource

    string

    Sumber unggahan aset media.

    general
    CateName

    string

    Nama kategori.

    cateName
    ReferenceId

    string

    ID unik pengguna kustom. Panjangnya harus 6 hingga 64 karakter dan hanya boleh berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

    123-1234
    FileInfoList

    array<object>

    Daftar objek FileInfo.

    array<object>

    FileBasicInfo

    object

    Informasi dasar file, seperti durasi dan ukuran.

    FileName

    string

    Nama file.

    example.mp4
    FileStatus

    string

    Status file.

    Normal
    FileType

    string

    Jenis file.

    source_file
    FileSize

    string

    Ukuran file dalam byte.

    30611502
    FileUrl

    string

    URL OSS file.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
    Region

    string

    Wilayah tempat file disimpan.

    cn-shanghai
    FormatName

    string

    Format kontainer.

    mov,mp4,m4a,3gp,3g2,mj2
    Duration

    string

    Durasi file dalam detik.

    216.206667
    Bitrate

    string

    Bitrate file dalam kbit/s.

    1132.68
    Width

    string

    Lebar video dalam piksel.

    960
    Height

    string

    Tinggi video dalam piksel.

    540
    CreateTime

    string

    Waktu pembuatan file. Waktu dalam UTC dan mengikuti format YYYY-MM-DDTHH:MM:SSZ.

    2020-12-26T04:11:08Z
    ModifiedTime

    string

    Waktu modifikasi terakhir file. Waktu dalam UTC dan mengikuti format YYYY-MM-DDTHH:MM:SSZ.

    2020-12-26T04:11:10Z
    AudioStreamInfoList

    array<object>

    Daftar informasi aliran audio. Satu aset media dapat berisi beberapa aliran audio.

    object

    Index

    string

    Indeks aliran audio.

    1
    CodecName

    string

    Nama singkat kodek.

    aac
    CodecLongName

    string

    Nama lengkap kodek.

    AAC (Advanced Audio Coding)
    CodecTimeBase

    string

    Time base kodek.

    1/24000
    CodecTagString

    string

    String tag kodek.

    mp4a
    CodecTag

    string

    Tag kodek.

    0x6134706d
    Profile

    string

    Profil pengkodean.

    High
    SampleFmt

    string

    Format sampel.

    fltp
    SampleRate

    string

    Laju sampel, dalam Hz.

    44100
    Channels

    string

    Jumlah saluran audio.

    2
    ChannelLayout

    string

    Tata letak saluran.

    stereo
    Timebase

    string

    Time base.

    1/44100
    StartTime

    string

    Waktu mulai, dalam detik.

    0.000000
    Duration

    string

    Durasi, dalam detik.

    16.200998
    Bitrate

    string

    Bitrate, dalam kbit/s.

    127.794
    Fps

    string

    Laju frame audio.

    8
    NumFrames

    string

    Total jumlah frame audio.

    10
    Lang

    string

    Bahasa.

    und
    VideoStreamInfoList

    array<object>

    Daftar informasi aliran video. Satu aset media dapat berisi beberapa aliran video.

    object

    Index

    string

    Indeks aliran video.

    0
    CodecName

    string

    Nama singkat kodek.

    h264
    CodecLongName

    string

    Nama lengkap kodek.

    H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
    Profile

    string

    Profil pengkodean.

    High
    CodecTimeBase

    string

    Time base kodek.

    1/48
    CodecTagString

    string

    String tag kodek.

    [0][0][0][0]
    CodecTag

    string

    Tag kodek.

    0x0000
    Width

    string

    Lebar video dalam piksel.

    960
    Height

    string

    Tinggi video dalam piksel.

    540
    HasBFrames

    string

    Menentukan apakah terdapat B-frame.

    2
    Sar

    string

    Rasio aspek sampel (SAR).

    0:1
    Dar

    string

    Rasio aspek tampilan (DAR).

    0:1
    PixFmt

    string

    Format piksel.

    yuv420p
    Level

    string

    Tingkat pengkodean.

    30
    Fps

    string

    Laju bingkai video.

    24.0
    AvgFPS

    string

    Laju bingkai rata-rata.

    24.0
    Timebase

    string

    Time base.

    1/12288
    StartTime

    string

    Waktu mulai, dalam detik.

    0.081706
    Duration

    string

    Durasi, dalam detik.

    216.206706
    Bitrate

    string

    Bitrate, dalam kbit/s.

    1001.594
    NumFrames

    string

    Total jumlah frame.

    5184
    Lang

    string

    Bahasa.

    und
    Rotate

    string

    Sudut rotasi video.

    0
    Nb_frames

    string

    Total jumlah frame video.

    5184
    SubtitleStreamInfoList

    array<object>

    Daftar informasi aliran subtitle. Satu aset media dapat berisi beberapa aliran subtitle.

    object

    Index

    string

    Indeks aliran subtitle.

    1
    CodecName

    string

    Nama singkat kodek.

    srt
    CodecLongName

    string

    Nama lengkap kodek.

    SubRip Text
    CodecTimeBase

    string

    Time base kodek.

    29.97
    CodecTagString

    string

    String tag kodek.

    unicode
    CodecTag

    string

    Tag kodek.

    unicode
    Timebase

    string

    Time base.

    30
    StartTime

    string

    Waktu mulai, dalam detik.

    0
    Duration

    string

    Durasi.

    1
    Lang

    string

    Bahasa.

    und
    AiRoughData

    object

    Data mentah analisis AI.

    Result

    string

    Hasil mentah analisis AI.

    https://sample-bucket.cn-shanghai.aliyuncs.com/result.json
    Status

    string

    Status analisis AI:

    • Analyzing: Analisis sedang berlangsung.

    • AnalyzeSuccess: Analisis berhasil.

    • AnalyzeFailed: Analisis gagal.

    • Saving: Data sedang disimpan.

    • SaveSuccess: Data tersimpan.

    • SaveFailed: Gagal menyimpan data.

    • Deleting: Data sedang dihapus.

    • DeleteSuccess: Data dihapus.

    • DeleteFailed: Gagal menghapus data.

    Analyzing
    SaveType

    string

    Jenis penyimpanan. Menentukan apakah hasil akan disimpan ke indeks pencarian setelah analisis AI selesai. Nilai yang valid:

    • TEXT: Indeks teks.

    TEXT
    AiCategory

    string

    Kategori AI. Nilai yang valid:

    • Lifestyle

    • Appearance

    • Pets

    • News

    • Advertisement

    • Environment

    • Automobile

    生活
    AiJobId

    string

    ID pekerjaan AI.

    ****483915d4f2cd8ac20b48fb04****
    StandardSmartTagJob

    object

    Pekerjaan tag.

    AiJobId

    string

    ID pekerjaan AI.

    ****483915d4f2cd8ac20b48fb04****
    Status

    string

    Status analisis AI:

    • Analyzing: Analisis sedang berlangsung.

    • AnalyzeSuccess: Analisis berhasil.

    • AnalyzeFailed: Analisis gagal.

    Analyzing
    ResultUrl

    string

    URL hasil tag.

    http://xx.oss-cn-shanghai.aliyuncs.com/result2.txt
    Results

    array<object>

    Daftar hasil pengenalan tag.

    object

    Hasil pengenalan tag

    Data

    string

    Hasil analisis detail berupa string JSON. Untuk struktur data masing-masing Type, lihat Deskripsi parameter Result.

    {"autoChapters": [...]}
    Type

    string

    Jenis identifikasi tag. Nilai yang valid:

    • NLP: Hasil dari Natural Language Processing (NLP).

    • TextLabel: Tag teks.

    • VideoLabel: Tag video.

    • ASR: Hasil mentah dari Automatic Speech Recognition (ASR).

    • OCR: Hasil mentah dari Optical Character Recognition (OCR).

    NLP

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "2FDE2411-DB8D-4A9A-875B-275798F14A5E",
  "MediaInfo": {
    "MediaId": "****20b48fb04483915d4f2cd8ac****",
    "MediaBasicInfo": {
      "MediaId": "****20b48fb04483915d4f2cd8ac****",
      "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
      "MediaType": "video",
      "BusinessType": "general",
      "Source": "oss",
      "Title": "Title",
      "Description": "Description",
      "Category": "Category",
      "MediaTags": "tag1",
      "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
      "UserData": "userDataTest",
      "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
      "Status": "Normal",
      "CreateTime": "2020-12-26T04:11:08Z",
      "ModifiedTime": "2020-12-26T04:11:10Z",
      "DeletedTime": "2020-12-26T04:11:15Z",
      "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
      "CateId": 3048,
      "Biz": "ICE",
      "UploadSource": "general",
      "CateName": "cateName",
      "ReferenceId": "123-1234"
    },
    "FileInfoList": [
      {
        "FileBasicInfo": {
          "FileName": "example.mp4",
          "FileStatus": "Normal",
          "FileType": "source_file",
          "FileSize": "30611502",
          "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
          "Region": "cn-shanghai",
          "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
          "Duration": "216.206667",
          "Bitrate": "1132.68",
          "Width": "960",
          "Height": "540",
          "CreateTime": "2020-12-26T04:11:08Z",
          "ModifiedTime": "2020-12-26T04:11:10Z"
        },
        "AudioStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "aac",
            "CodecLongName": "AAC (Advanced Audio Coding)",
            "CodecTimeBase": "1/24000",
            "CodecTagString": "mp4a",
            "CodecTag": "0x6134706d",
            "Profile": "High",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "Channels": "2",
            "ChannelLayout": "stereo",
            "Timebase": "1/44100",
            "StartTime": "0.000000",
            "Duration": "16.200998",
            "Bitrate": "127.794",
            "Fps": "8",
            "NumFrames": "10",
            "Lang": "und"
          }
        ],
        "VideoStreamInfoList": [
          {
            "Index": "0",
            "CodecName": "h264",
            "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "Profile": "High",
            "CodecTimeBase": "1/48",
            "CodecTagString": "[0][0][0][0]",
            "CodecTag": "0x0000",
            "Width": "960",
            "Height": "540",
            "HasBFrames": "2",
            "Sar": "0:1",
            "Dar": "0:1",
            "PixFmt": "yuv420p",
            "Level": "30",
            "Fps": "24.0",
            "AvgFPS": "24.0",
            "Timebase": "1/12288",
            "StartTime": "0.081706",
            "Duration": "216.206706",
            "Bitrate": "1001.594",
            "NumFrames": "5184",
            "Lang": "und",
            "Rotate": "0",
            "Nb_frames": "5184"
          }
        ],
        "SubtitleStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "srt",
            "CodecLongName": "SubRip Text",
            "CodecTimeBase": "29.97",
            "CodecTagString": "unicode",
            "CodecTag": "unicode",
            "Timebase": "30",
            "StartTime": "0",
            "Duration": "1",
            "Lang": "und"
          }
        ]
      }
    ],
    "AiRoughData": {
      "Result": "https://sample-bucket.cn-shanghai.aliyuncs.com/result.json",
      "Status": "Analyzing",
      "SaveType": "TEXT",
      "AiCategory": "生活",
      "AiJobId": "****483915d4f2cd8ac20b48fb04****",
      "StandardSmartTagJob": {
        "AiJobId": "****483915d4f2cd8ac20b48fb04****",
        "Status": "Analyzing",
        "ResultUrl": "http://xx.oss-cn-shanghai.aliyuncs.com/result2.txt",
        "Results": [
          {
            "Data": "{\"autoChapters\": [...]}",
            "Type": "NLP"
          }
        ]
      }
    }
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.