GetPublicMediaInfo - Intelligent Media Services - Alibaba Cloud Documentation Center

Obtain and return media asset information based on the mediaId of an ICE public copyright media asset. The URL returned by the API is a preview or audition address for the copyright media asset. The official material will be used during synthesis.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
MediaId	string	No	IMS media asset ID	icepublic-**14e501538aeef0a3140176f6**

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	RequestId	****11-DB8D-4A9A-875B-275798****
MediaInfo	object	Media asset information
MediaId	string	Media asset ID	icepublic-**14e501538aeef0a3140176f6**
MediaBasicInfo	object	BasicInfo
MediaId	string	MediaId	icepublic-**14e501538aeef0a3140176f6**
MediaType	string	media asset Type	video
BusinessType	string	Media asset business type	general
Source	string	Source	oss
Title	string	title	title
Description	string	Content description	description
Category	string	categorization	category
MediaTags	string	label	Tag,tag1
CoverURL	string	thumbnail URL	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	User Data	{"key":"value"}
Status	string	Resource status	Normal
CreateTime	string	Media asset creation time	2020-12-26T04:11:08Z
ModifiedTime	string	Updated At	2020-12-26T04:11:10Z
DeletedTime	string	Media asset deletion time	2020-12-26T04:11:15Z
SpriteImages	string	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"}]
DynamicMetaData	object	Public media asset dynamic metadata
Type	string	Type. Valid values: "ai": AI data processed from raw AI results "user-defined": User-defined metadata "system": System-provided	system
Data	string	Metadata in JSON format	{"AuditionUrl": "http://example-bucket.cdn.domain.com/example.mp4", "AuditionCount": 3}
FileInfoList	array<object>	FileInfos
	array<object>
FileBasicInfo	object	Basic file information, including duration and size.
FileName	string	File name	example.mp4
FileStatus	string	File status	Normal
FileType	string	File type	source_file
FileSize	string	File Size (bytes)	27007
FileUrl	string	Preview or sample playback URL for the copyrighted media asset.	http://example-bucket.cdn.domain.com/example.mp4
Region	string	File storage area	cn-shanghai
FormatName	string	Container format	mp4
Duration	string	Duration	16.2
Bitrate	string	Bitrate	192.0
Width	string	Width	0
Height	string	Height	0
AudioStreamInfoList	array<object>	Audio stream information. A media asset may contain multiple audio streams.
	object
Index	string	Audio stream ordinal number	1
CodecName	string	short name of the encoding format	aac
CodecLongName	string	Long name of the encoding format	AAC (Advanced Audio Coding)
CodecTimeBase	string	Codec time base	1/44100
CodecTagString	string	Encoding format tag text	mp4a
CodecTag	string	Encoding format tag	0x6134706d
Profile	string	codec profile	High
SampleFmt	string	Sampling format	fltp
SampleRate	string	Sample rate	44100
Channels	string	the number of sound channels	2
ChannelLayout	string	Sound channel output layout	stereo
Timebase	string	Timebase	1/44100
StartTime	string	Start time	0.000000
Duration	string	Duration	16.2
Bitrate	string	bitrate	192.0
Fps	string	Audio frame rate	10
NumFrames	string	Total number of frames	162
Lang	string	Language	und
VideoStreamInfoList	array<object>	Video stream information; a media asset may contain multiple video streams.
	object
Index	string	Video stream ordinal number	0
CodecName	string	Encoding format short name	h264
CodecLongName	string	Long name of the encoding format	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	codec profile	High
CodecTimeBase	string	Codec time base	1/48
CodecTagString	string	Encoding format mark text	[0][0][0][0]
CodecTag	string	Encoding format tag	0x0000
Width	string	Width	960
Height	string	Height	540
HasBFrames	string	Whether B-frames are present	2
Sar	string	Sample Aspect Ratio (SAR)	0:1
Dar	string	Encoded display aspect ratio	0:1
PixFmt	string	Pixel format	yuv420p
Level	string	Encoding Level	30
Fps	string	video frame rate	24.0
AvgFPS	string	average frame rate	24.0
Timebase	string	time base	1/12288
StartTime	string	start time	0.081706
Duration	string	Duration	216.206706
Bitrate	string	bitrate	1001.594
NumFrames	string	Total number of frames	5184
Lang	string	Language	und
Rotate	string	rotate	0
Nb_frames	string	total number of frames	5184
SubtitleStreamInfoList	array<object>	Caption stream information. A media asset may have multiple caption streams.
	object
Index	string	Caption stream ordinal number	1
CodecName	string	Brief name of encoding format	srt
CodecLongName	string	Long name of encoding format	SubRip Text
CodecTimeBase	string	Codec time base	29.97
CodecTagString	string	Encoding format mark text	unicode
CodecTag	string	Encoding format tag	unicode
Timebase	string	Time base	30
StartTime	string	Start time	0
Duration	string	Duration	1
Lang	string	Language	und

Examples

Success response

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfo": {
    "MediaId": "icepublic-****14e501538aeef0a3140176f6****",
    "MediaBasicInfo": {
      "MediaId": "icepublic-****14e501538aeef0a3140176f6****",
      "MediaType": "video",
      "BusinessType": "general",
      "Source": "oss",
      "Title": "title",
      "Description": "description",
      "Category": "category",
      "MediaTags": "Tag,tag1",
      "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
      "UserData": "{\"key\":\"value\"}",
      "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\"}]"
    },
    "DynamicMetaData": {
      "Type": "system",
      "Data": "{\"AuditionUrl\": \"http://example-bucket.cdn.domain.com/example.mp4\", \"AuditionCount\": 3}"
    },
    "FileInfoList": [
      {
        "FileBasicInfo": {
          "FileName": "example.mp4",
          "FileStatus": "Normal",
          "FileType": "source_file",
          "FileSize": "27007",
          "FileUrl": "http://example-bucket.cdn.domain.com/example.mp4",
          "Region": "cn-shanghai",
          "FormatName": "mp4",
          "Duration": "16.2",
          "Bitrate": "192.0",
          "Width": "0",
          "Height": "0"
        },
        "AudioStreamInfoList": [
          {
            "Index": "1",
            "CodecName": "aac",
            "CodecLongName": "AAC (Advanced Audio Coding)",
            "CodecTimeBase": "1/44100",
            "CodecTagString": "mp4a",
            "CodecTag": "0x6134706d",
            "Profile": "High",
            "SampleFmt": "fltp",
            "SampleRate": "44100",
            "Channels": "2",
            "ChannelLayout": "stereo",
            "Timebase": "1/44100",
            "StartTime": "0.000000",
            "Duration": "16.2",
            "Bitrate": "192.0",
            "Fps": "10",
            "NumFrames": "162",
            "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"
          }
        ]
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.