GetPublicMediaInfo-Intelligent Media Services(IMS)-阿里云帮助中心

Retrieves the information about an ICE public copyrighted media asset based on the media asset ID. The URL returned by the API operation is the preview or trial playback address of the copyrighted media asset, and the official material is used during production.

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	The 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	The media asset information.
MediaId	string	The ID of the media asset.	icepublic-**14e501538aeef0a3140176f6**
MediaBasicInfo	object	BasicInfo
MediaId	string	MediaId	icepublic-**14e501538aeef0a3140176f6**
MediaType	string	The media type of the media asset.	video
BusinessType	string	The business type of the media asset.	general
Source	string	The source of the media asset.	oss
Title	string	The title of the media asset.	title
Description	string	The description of the media asset.	description
Category	string	The category of the media asset.	category
MediaTags	string	The tags of the media asset.	tag1,tag2
CoverURL	string	The URL of the cover image.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	The user data.	{"key":"value"}
Status	string	The status of the resource.	Normal
CreateTime	string	The time when the media asset was created.	2020-12-26T04:11:08Z
ModifiedTime	string	The time when the media asset was modified.	2020-12-26T04:11:10Z
DeletedTime	string	The time when the media asset was deleted.	2020-12-26T04:11:15Z
SpriteImages	string	The sprite images.	[{"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	The dynamic metadata of the public media asset.
Type	string	The type. Valid values: "ai": AI data processed from original AI results "user-defined": user-defined metadata "system": system-generated metadata	system
Data	string	The metadata in JSON format.	{"AuditionUrl": "http://example-bucket.cdn.domain.com/example.mp4", "AuditionCount": 3}
FileInfoList	array<object>	FileInfos
	array<object>	The media file information.
FileBasicInfo	object	The basic information about the file, including the duration and size.
FileName	string	The name of the file.	example.mp4
FileStatus	string	The status of the file.	Normal
FileType	string	The type of the file.	source_file
FileSize	string	The size of the file in bytes.	27007
FileUrl	string	The preview URL for copyrighted media assets.	http://example-bucket.cdn.domain.com/example.mp4
Region	string	The region where the file is stored.	cn-shanghai
FormatName	string	The container format of the file.	mp4
Duration	string	The duration of the file.	16.2
Bitrate	string	The bitrate of the file.	192.0
Width	string	The width of the video.	0
Height	string	The height of the video.	0
AudioStreamInfoList	array<object>	The audio stream information. A media asset may contain multiple audio streams.
	object	The audio stream information.
Index	string	The index of the audio stream.	1
CodecName	string	The short name of the codec.	aac
CodecLongName	string	The long name of the codec.	AAC (Advanced Audio Coding)
CodecTimeBase	string	The time base of the codec.	1/44100
CodecTagString	string	The codec tag string.	mp4a
CodecTag	string	The codec tag.	0x6134706d
Profile	string	The codec profile.	High
SampleFmt	string	The sampling format.	fltp
SampleRate	string	The sample rate.	44100
Channels	string	The number of channels.	2
ChannelLayout	string	The channel layout.	stereo
Timebase	string	The timebase.	1/44100
StartTime	string	The start time.	0.000000
Duration	string	The duration of the file.	16.2
Bitrate	string	The bitrate of the file.	192.0
Fps	string	The audio frame rate.	10
NumFrames	string	The total number of frames.	162
Lang	string	The language.	und
VideoStreamInfoList	array<object>	The video stream information. A media asset may contain multiple video streams.
	object	The video stream information.
Index	string	The index of the video stream.	0
CodecName	string	The short name of the codec.	h264
CodecLongName	string	The long name of the codec.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	The codec profile.	High
CodecTimeBase	string	The time base of the codec.	1/48
CodecTagString	string	The codec tag string.	[0][0][0][0]
CodecTag	string	The codec tag.	0x0000
Width	string	The width of the video.	960
Height	string	The height of the video.	540
HasBFrames	string	Indicates whether the video stream contains B-frames.	2
Sar	string	The sample aspect ratio.	0:1
Dar	string	The display aspect ratio.	0:1
PixFmt	string	The pixel format.	yuv420p
Level	string	The encoding level.	30
Fps	string	The video frame rate.	24.0
AvgFPS	string	The average frame rate.	24.0
Timebase	string	The timebase.	1/12288
StartTime	string	The start time.	0.081706
Duration	string	The duration of the file.	216.206706
Bitrate	string	The bitrate of the file.	1001.594
NumFrames	string	The total number of frames.	5184
Lang	string	The language.	und
Rotate	string	The rotation angle.	0
Nb_frames	string	The total number of frames.	5184
SubtitleStreamInfoList	array<object>	The subtitle stream information. A media asset may contain multiple subtitle streams.
	object	The subtitle stream information.
Index	string	The index of the subtitle stream.	1
CodecName	string	The short name of the codec.	srt
CodecLongName	string	The long name of the codec.	SubRip Text
CodecTimeBase	string	The time base of the codec.	29.97
CodecTagString	string	The codec tag string.	unicode
CodecTag	string	The codec tag.	unicode
Timebase	string	The timebase.	30
StartTime	string	The start time.	0
Duration	string	The duration of the file.	1
Lang	string	The 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": "tag1,tag2",
      "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.