All Products
Search
Document Center

ApsaraVideo VOD:GetMezzanineInfo

Last Updated:Oct 19, 2026

Mengambil informasi file sumber dari file audio atau video, termasuk URL file, resolusi, dan bitrate.

Deskripsi operasi

Anda dapat mengambil informasi file sumber lengkap hanya setelah aliran video atau aliran audio ditranskode.

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

vod:GetMezzanineInfo

get

*Semua resource.

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

VideoId

string

No

ID audio atau video. Anda dapat memperoleh ID dengan menggunakan salah satu metode berikut:

  • Untuk file audio atau video yang diunggah di konsol, log masuk ke Konsol ApsaraVideo VOD dan pilih Aset Media > Audio/Video untuk melihat ID video.

  • Saat Anda memanggil operasi Obtain the upload URL and credential for a video untuk mendapatkan URL unggah dan kredensial, ID audio atau video adalah nilai dari parameter respons VideoId.

  • Setelah video diunggah, Anda dapat memanggil operasi Search media information untuk mengkueri ID audio atau video, yang merupakan nilai dari parameter respons VideoId.

1f1a6fc03ca04814031b8a6559e****

AuthTimeout

integer

No

Waktu kedaluwarsa tanda tangan untuk FileURL (URL file sumber). Unit: detik. Nilai default: 3600. Nilai minimum: 1.

  • Jika OutputType diatur ke cdn:
    • FileURL kedaluwarsa secara berkala hanya jika otentikasi URL diaktifkan. Jika tidak, FileURL berlaku secara permanen.

    • Nilai minimum: 1.

    • Nilai maksimum: tanpa batas.

    • Nilai default: 3600 jika tidak ditentukan.

  • Jika OutputType diatur ke oss:
    • FileURL kedaluwarsa secara berkala hanya jika izin penyimpanan diatur ke private. Jika tidak, FileURL berlaku secara permanen.

    • Nilai minimum: 1.

    • Nilai maksimum: Untuk mengurangi risiko keamanan server asal, nilai maksimum adalah 2592000 (30 hari) ketika file audio atau video disimpan di bucket ApsaraVideo VOD, dan 129600 (36 jam) ketika file audio atau video disimpan di bucket OSS milik pengguna.

    • Nilai default: 3600 jika tidak ditentukan.

3600

OutputType

string

No

Tipe URL keluaran. Nilai valid:

  • oss: URL asal.

  • cdn (default): URL dipercepat.

Catatan

Jika bucket tempat file sumber disimpan bertipe in, hanya URL OSS yang dikembalikan.

oss

AdditionType

string

No

Tipe informasi tambahan. Pisahkan beberapa nilai dengan koma (,). Secara default, hanya informasi dasar yang dikembalikan. Nilai valid:

  • video: informasi aliran video.

  • audio: informasi aliran audio.

video

ReferenceId

string

No

ID kustom. ID harus memiliki panjang 6 hingga 64 karakter dan hanya dapat berisi huruf kecil, huruf besar, angka, tanda hubung (-), dan garis bawah (_). ID harus unik per pengguna.

123-123

Elemen respons

Element

Type

Description

Example

object

Tanggapan.

RequestId

string

ID permintaan.

25818875-5F78-4AF6-D7393642CA58****

Mezzanine

object

Informasi file.

CreationTime

string

Waktu pembuatan file. Waktu mengikuti format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

2017-11-14T09:15:50Z

Status

string

Status file. Nilai valid:

  • Uploading: File sedang diunggah. Ini adalah status awal file.

  • Normal: File telah diunggah.

  • UploadFail: File gagal diunggah.

  • Deleted: File telah dihapus.

Normal

FileURL

string

URL file sumber.

http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4

VideoId

string

ID video.

1f1a6fc03ca04814031b8a6559e****

Height

integer

Tinggi file. Unit: piksel.

540

Bitrate

string

Bitrate file. Unit: Kbps.

771.2280

FileName

string

Nama file.

27ffc438-164h67f57ef-0005-6884-51a-1****.mp4

OutputType

string

Tipe URL keluaran. Nilai valid:

  • oss: URL asal.

  • cdn (default): URL dipercepat.

Catatan

Hanya URL OSS untuk pemutaran MP4 yang didukung.

oss

PreprocessStatus

string

Status prapemrosesan. Nilai valid:

  • UnPreprocess: Tidak dipraproses.

  • Preprocessing: Sedang dipraproses.

  • PreprocessSucceed: Dipraproses.

  • PreprocessFailed: Prapemrosesan gagal.

UnPreprocess

Width

integer

Lebar file. Unit: piksel.

960

Size

integer

Ukuran file. Unit: byte.

4096477

Duration

string

Durasi file. Unit: detik.

42.4930

Fps

string

Laju frame file, yang menunjukkan jumlah frame per detik.

25.0000

AudioStreamList

array<object>

Informasi aliran audio.

object

Detail aliran audio.

Index

string

Nomor urut aliran audio, yang mengidentifikasi posisi aliran audio dalam seluruh aliran media.

0

Timebase

string

Basis waktu.

0.000000

SampleFmt

string

Format pengambilan sampel.

fltp

SampleRate

string

Laju sampel.

44100

ChannelLayout

string

Tata letak saluran. Nilai valid:

  • mono: mono.

  • stereo: stereo.

mono

Lang

string

Bahasa.

und

CodecLongName

string

Nama panjang format Kodek.

AAC (Advanced Audio Coding)

Channels

string

Jumlah saluran suara.

1

NumFrames

string

Jumlah total frame.

1

Bitrate

string

Bitrate.

62.885

CodecTagString

string

String tag Kodek.

mp4a

StartTime

string

Waktu mulai. Waktu mengikuti format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

2017-01-11T12:00:00Z

CodecName

string

Nama pendek format Kodek.

aac

Duration

string

Durasi.

3.227574

CodecTag

string

Tag Kodek.

0x6134706d

CodecTimeBase

string

Basis waktu Kodek.

1/44100

VideoStreamList

array<object>

Informasi aliran video.

object

Detail aliran video.

Timebase

string

Basis waktu.

0.000000

Index

string

Nomor urut aliran video, yang mengidentifikasi posisi aliran video dalam seluruh aliran media.

1

AvgFPS

string

Laju frame rata-rata.

30.0

PixFmt

string

Format piksel.

yuv420p

Lang

string

Bahasa.

und

Sar

string

Rasio aspek sampel.

0:1

Height

string

Tinggi video.

320

CodecLongName

string

Nama panjang format Kodek.

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

NumFrames

string

Jumlah total frame.

0

Bitrate

string

Bitrate file. Unit: Kbps.

500

Rotate

string

Sudut rotasi video. Nilai valid: [0, 360).

90

CodecTagString

string

String tag Kodek.

avc1

HasBFrames

string

Apakah video berisi B-frame.

0

Profile

string

Profil codec.

Main

StartTime

string

Waktu mulai. Waktu mengikuti format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

2017-01-11T12:00:00Z

Dar

string

Rasio aspek tampilan.

0:1

CodecName

string

Nama pendek format Kodek.

h264

Width

string

Lebar video.

568

Duration

string

Durasi.

3.166667

Fps

string

Laju frame target.

30.0

CodecTag

string

Tag Kodek.

0x31637661

CodecTimeBase

string

Basis waktu Kodek.

1/60

Level

string

Level Kodek.

30

HDRType

string

Tipe HDR aliran video.

HDR

StorageClass

string

Kelas penyimpanan aset media. Nilai valid:

  • Standard: Jenis Penyimpanan Standar.

  • IA: Akses Jarang untuk aset media.

  • Archive: Arsip untuk aset media.

  • ColdArchive: Penyimpanan Arsip Dingin untuk aset media.

  • SourceIA: Akses Jarang untuk file sumber.

  • SourceArchive: Arsip untuk file sumber.

  • SourceColdArchive: Penyimpanan Arsip Dingin untuk file sumber.

  • Changing: Kelas penyimpanan aset media sedang diubah.

  • SourceChanging: Kelas penyimpanan file sumber sedang diubah.

Standard

RestoreStatus

string

Status pemulihan aset media. Nilai valid:

  • Processing: Memulihkan.

  • Success: Dipulihkan.

  • Failed: Pemulihan gagal.

Success

RestoreExpiration

string

Waktu kedaluwarsa pemulihan aset media.

2023-03-30T10:14:14Z

FileMD5

string

Hash MD5 file sumber.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Mezzanine": {
    "CreationTime": "2017-11-14T09:15:50Z",
    "Status": "Normal",
    "FileURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "VideoId": "1f1a6fc03ca04814031b8a6559e****",
    "Height": 540,
    "Bitrate": "771.2280",
    "FileName": "27ffc438-164h67f57ef-0005-6884-51a-1****.mp4",
    "OutputType": "oss",
    "PreprocessStatus": "UnPreprocess",
    "Width": 960,
    "Size": 4096477,
    "Duration": "42.4930",
    "Fps": "25.0000",
    "AudioStreamList": [
      {
        "Index": "0",
        "Timebase": "0.000000",
        "SampleFmt": "fltp",
        "SampleRate": "44100",
        "ChannelLayout": "mono",
        "Lang": "und",
        "CodecLongName": "AAC (Advanced Audio Coding)",
        "Channels": "1",
        "NumFrames": "1",
        "Bitrate": "62.885",
        "CodecTagString": "mp4a",
        "StartTime": "2017-01-11T12:00:00Z",
        "CodecName": "aac",
        "Duration": "3.227574",
        "CodecTag": "0x6134706d",
        "CodecTimeBase": "1/44100"
      }
    ],
    "VideoStreamList": [
      {
        "Timebase": "0.000000",
        "Index": "1",
        "AvgFPS": "30.0",
        "PixFmt": "yuv420p",
        "Lang": "und",
        "Sar": "0:1",
        "Height": "320",
        "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
        "NumFrames": "0",
        "Bitrate": "500",
        "Rotate": "90",
        "CodecTagString": "avc1",
        "HasBFrames": "0",
        "Profile": "Main",
        "StartTime": "2017-01-11T12:00:00Z",
        "Dar": "0:1",
        "CodecName": "h264",
        "Width": "568",
        "Duration": "3.166667",
        "Fps": "30.0",
        "CodecTag": "0x31637661",
        "CodecTimeBase": "1/60",
        "Level": "30",
        "HDRType": "HDR"
      }
    ],
    "StorageClass": "Standard",
    "RestoreStatus": "Success",
    "RestoreExpiration": "2023-03-30T10:14:14Z",
    "FileMD5": ""
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.