Ikhtisar API GetMediaInfo & Metadata Aset Media - Layanan Media Cerdas - Alibaba Cloud - Intelligent Media Services

Mengambil informasi aset media berdasarkan ID media IMS atau URL input.

Deskripsi operasi

Jika MediaId tidak kosong, parameter ini akan diutamakan. Jika MediaId kosong, InputURL harus ditentukan.

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 Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MediaId	string	No	ID aset media IMS. Jika parameter ini kosong, InputURL harus ditentukan.	**20b48fb04483915d4f2cd8ac**
InputURL	string	No	URL aset media yang akan dikueri di sistem terkait. Sebelum digunakan, aset media harus didaftarkan di pustaka konten IMS dan dikaitkan dengan ID media IMS. URL OSS. Mendukung dua format: http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 atau oss://example-bucket/example.mp4. Dalam format ini, wilayah OSS default sama dengan wilayah pendaftaran layanan.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
OutputType	string	No	Tipe URL file aset media dalam tanggapan. Nilai valid: "oss": Mengembalikan URL OSS. Ini adalah nilai default. "cdn": Mengembalikan URL CDN. URL CDN hanya dikembalikan jika aset media diimpor dari ApsaraVideo VOD dan nama domain yang dipercepat telah dikonfigurasi di ApsaraVideo VOD.	cdn
ReturnDetailedInfo	string	No	Apakah akan mengembalikan informasi detail untuk bidang aset media terkait. Bidang yang didukung: AiRoughData.StandardSmartTagJob: Apakah akan mengembalikan hasil penandaan detail jika aset media telah dikirim untuk analisis tag. Nilai valid: false: Hasil tugas dikembalikan sebagai URL. Ini adalah nilai default. 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	MediaId.	**20b48fb04483915d4f2cd8ac**
InputURL	string	URL aset media yang dikueri di sistem terkait.	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	Tipe media aset media.	video
BusinessType	string	Tipe bisnis aset media.	general
Source	string	Sumber.	oss
Title	string	Judul.	Title
Description	string	Deskripsi.	Description
Category	string	Kategori.	Category
MediaTags	string	Tag.	Tag,tag1
CoverURL	string	URL sampul.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	Data pengguna.	userDataTest
Snapshots	string	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 sumber daya.	Normal
CreateTime	string	Waktu pembuatan aset media. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:08Z
ModifiedTime	string	Waktu modifikasi aset media. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:10Z
DeletedTime	string	Waktu penghapusan aset media. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:15Z
SpriteImages	string	Gambar sprite.	[{"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 tempat aset media berada.	ICE
UploadSource	string	Sumber unggahan aset media.	general
CateName	string	Nama kategori.	cateName
ReferenceId	string	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 dalam dimensi pengguna.	123-1234
FileInfoList	array<object>	Daftar informasi file.
	array<object>
FileBasicInfo	object	Informasi dasar file, termasuk durasi dan ukuran.
FileName	string	Nama file.	example.mp4
FileStatus	string	Status file.	Normal
FileType	string	Tipe 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 penyimpanan file.	cn-shanghai
FormatName	string	Format kontainer.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	Durasi.	216.206667
Bitrate	string	Bitrate.	1132.68
Width	string	Lebar.	960
Height	string	Tinggi.	540
CreateTime	string	Waktu pembuatan file. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:08Z
ModifiedTime	string	Waktu modifikasi file. Waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (diakhiri dengan Z).	2020-12-26T04:11:10Z
AudioStreamInfoList	array<object>	Informasi aliran audio. Aset media dapat berisi beberapa aliran audio.
	object
Index	string	Indeks aliran audio.	1
CodecName	string	Nama singkat kodek.	aac
CodecLongName	string	Nama panjang kodek.	AAC (Advanced Audio Coding)
CodecTimeBase	string	Basis pengatur waktu Kodek.	1/24000
CodecTagString	string	String tag format kodek.	mp4a
CodecTag	string	Tag format kodek.	0x6134706d
Profile	string	Profil Kodek.	High
SampleFmt	string	Format sampel.	fltp
SampleRate	string	Laju sampel.	44100
Channels	string	Jumlah saluran.	2
ChannelLayout	string	Tata letak output saluran.	stereo
Timebase	string	Basis pengatur waktu.	1/44100
StartTime	string	Waktu mulai, dalam detik.	0.000000
Duration	string	Durasi.	16.200998
Bitrate	string	Bitrate.	127.794
Fps	string	Laju frame audio.	8
NumFrames	string	Jumlah total frame.	10
Lang	string	Bahasa.	und
VideoStreamInfoList	array<object>	Informasi aliran video. Aset media dapat berisi beberapa aliran video.
	object
Index	string	Indeks aliran video.	0
CodecName	string	Nama singkat kodek.	h264
CodecLongName	string	Nama panjang kodek.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	Profil Kodek.	High
CodecTimeBase	string	Basis pengatur waktu Kodek.	1/48
CodecTagString	string	String tag format kodek.	[0][0][0][0]
CodecTag	string	Tag format kodek.	0x0000
Width	string	Lebar.	960
Height	string	Tinggi.	540
HasBFrames	string	Apakah aliran video berisi B-frame.	2
Sar	string	Rasio aspek sampel.	0:1
Dar	string	Rasio aspek tampilan.	0:1
PixFmt	string	Format piksel.	yuv420p
Level	string	Level kodek.	30
Fps	string	Laju frame video.	24.0
AvgFPS	string	Laju frame rata-rata.	24.0
Timebase	string	Basis pengatur waktu.	1/12288
StartTime	string	Waktu mulai, dalam detik.	0.081706
Duration	string	Durasi.	216.206706
Bitrate	string	Bitrate.	1001.594
NumFrames	string	Jumlah total frame.	5184
Lang	string	Bahasa.	und
Rotate	string	Rotasi.	0
Nb_frames	string	Jumlah total frame.	5184
SubtitleStreamInfoList	array<object>	Informasi aliran subtitle. Aset media dapat berisi beberapa aliran subtitle.
	object
Index	string	Indeks aliran subtitle.	1
CodecName	string	Nama singkat kodek.	srt
CodecLongName	string	Nama panjang kodek.	SubRip Text
CodecTimeBase	string	Basis waktu kodek.	29.97
CodecTagString	string	String tag format kodek.	unicode
CodecTag	string	Tag format kodek.	unicode
Timebase	string	Basis waktu.	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. Nilai valid: Analyzing: menganalisis AnalyzeSuccess: analisis berhasil AnalyzeFailed: analisis gagal Saving: menyimpan SaveSuccess: penyimpanan berhasil SaveFailed: penyimpanan gagal Deleting: menghapus DeleteSuccess: penghapusan berhasil DeleteFailed: penghapusan gagal	Analyzing
SaveType	string	Tipe penyimpanan. Apakah akan menyimpan data di pustaka pencarian setelah analisis cerdas selesai. Nilai valid: TEXT: pustaka teks	TEXT
AiCategory	string	Kategori AI. Nilai valid: Lifestyle Beauty Cute pets News Advertisement Environment and resources Automotive	Lifestyle
AiJobId	string	ID pekerjaan AI.	**483915d4f2cd8ac20b48fb04**
StandardSmartTagJob	object	Pekerjaan tag.
AiJobId	string	ID pekerjaan AI.	**483915d4f2cd8ac20b48fb04**
Status	string	Status analisis AI. Nilai valid: Analyzing: menganalisis 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	Data spesifik dari hasil analisis, direpresentasikan sebagai string JSON. Untuk struktur data dari berbagai tipe, lihat Deskripsi parameter Result.	{"autoChapters": [...]}
Type	string	Tipe pengenalan tag. Nilai valid: NLP: Hasil pemrosesan NLP TextLabel: tag teks VideoLabel: tag video ASR: Hasil pengenalan suara mentah OCR: Hasil OCR mentah	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": "标题",
      "Description": "描述",
      "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.