GetMediaInfo - - Centre de documentation Alibaba Cloud

Obtient les informations sur les ressources multimédias en fonction de l'identifiant de média IMS ou de l'URL d'entrée de la ressource multimédia.

Description de l'opération

Si MediaId est spécifié, il est prioritaire. Si MediaId est vide, InputURL doit être spécifié.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ice:GetMediaInfo

get

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
MediaId	string	Non	L'identifiant de la ressource multimédia IMS. Si ce paramètre est vide, InputURL doit être spécifié.	**20b48fb04483915d4f2cd8ac**
InputURL	string	Non	L'URL de la ressource multimédia à interroger dans le système correspondant. Avant utilisation, la ressource multimédia doit être enregistrée dans la bibliothèque de contenu IMS et associée à un identifiant de média IMS. URL OSS. Deux formats sont pris en charge : http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 ou oss://example-bucket/example.mp4. Dans ce format, la région OSS par défaut est identique à la zone d'enregistrement du service.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
OutputType	string	Non	Le type d'URL du fichier de ressource multimédia dans la réponse. Valeurs valides : oss : renvoie l'URL OSS. Il s'agit de la valeur par défaut. cdn : renvoie l'URL CDN. Une URL CDN est renvoyée uniquement lorsque la ressource multimédia est importée depuis ApsaraVideo VOD et qu'un nom de domaine accéléré est configuré dans ApsaraVideo VOD.	cdn
ReturnDetailedInfo	string	Non	Indique si des informations détaillées doivent être renvoyées pour les champs de ressources multimédias correspondants. Champs pris en charge : AiRoughData.StandardSmartTagJob : indique si les résultats détaillés de l'étiquetage doivent être renvoyés lorsque la ressource multimédia a été soumise à une analyse des balises. Valeur par défaut : false. Le résultat de la tâche est renvoyé sous forme d'URL. true : le résultat de la tâche est renvoyé sous forme de texte.	{"AiRoughData.StandardSmartTagJob": false}
AuthTimeout	integer	Non

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	2FDE2411-DB8D-4A9A-875B-275798F14A5E
MediaInfo	object	Les informations sur la ressource média.
MediaId	string	L'identifiant de la ressource média.	**20b48fb04483915d4f2cd8ac**
MediaBasicInfo	object	Informations de base.
MediaId	string	Identifiant de la ressource média.	**20b48fb04483915d4f2cd8ac**
InputURL	string	L'URL de la ressource média interrogée dans le système correspondant.	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	Le type de média de la ressource média.	video
BusinessType	string	Le type d'activité de la ressource média.	general
Source	string	La source.	oss
Title	string	Le titre.	Title
Description	string	La description.	Description
Category	string	La catégorie.	Category
MediaTags	string	Les balises.	tag1
CoverURL	string	L'URL de la couverture.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	Les données utilisateur.	userDataTest
Snapshots	string	Les instantanés.	[ "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	L'état de la ressource.	Normal
CreateTime	string	L'heure de création de la ressource média. L'heure est en UTC et suit la norme ISO 8601.	2020-12-26T04:11:08Z
ModifiedTime	string	L'heure de modification de la ressource média. L'heure est en UTC et suit la norme ISO 8601.	2020-12-26T04:11:10Z
DeletedTime	string	L'heure de suppression de la ressource média. L'heure est en UTC et suit la norme ISO 8601.	2020-12-26T04:11:15Z
SpriteImages	string	Les images de 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	L'identifiant de la catégorie.	3048
Biz	string	L'activité à laquelle la ressource média appartient.	ICE
UploadSource	string	La source de téléversement de la ressource média.	general
CateName	string	Le nom de la catégorie.	cateName
ReferenceId	string	L'identifiant personnalisé. L'identifiant doit comporter de 6 à 64 caractères et ne peut contenir que des lettres minuscules, des lettres majuscules, des chiffres, des traits d'union et des traits de soulignement. Il doit être unique au sein de la dimension utilisateur.	123-1234
FileInfoList	array<object>	La liste des informations sur les fichiers.
	array<object>
FileBasicInfo	object	Les informations de base sur le fichier, y compris la durée et la taille.
FileName	string	Le nom du fichier.	example.mp4
FileStatus	string	L'état du fichier.	Normal
FileType	string	Le type de fichier.	source_file
FileSize	string	La taille du fichier en octets.	30611502
FileUrl	string	L'URL OSS du fichier.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	La région de stockage du fichier.	cn-shanghai
FormatName	string	Le format d'encapsulation.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	La durée.	216.206667
Bitrate	string	Le débit binaire.	1132.68
Width	string	La largeur.	960
Height	string	La hauteur.	540
CreateTime	string	L'heure de création du fichier. L'heure est en UTC et suit la norme ISO 8601.	2020-12-26T04:11:08Z
ModifiedTime	string	L'heure de modification du fichier. L'heure est en UTC et suit la norme ISO 8601.	2020-12-26T04:11:10Z
AudioStreamInfoList	array<object>	Les informations sur le flux audio. Une ressource média peut contenir plusieurs flux audio.
	object
Index	string	L'index du flux audio.	1
CodecName	string	Le nom court du codec.	aac
CodecLongName	string	Le nom long du codec.	AAC (Advanced Audio Coding)
CodecTimeBase	string	La base de temps du codec.	1/24000
CodecTagString	string	La chaîne de balise du codec.	mp4a
CodecTag	string	La balise du codec.	0x6134706d
Profile	string	Le profil d'encodage.	High
SampleFmt	string	Le format d'échantillon.	fltp
SampleRate	string	Le taux d'échantillonnage.	44100
Channels	string	Le nombre de canaux.	2
ChannelLayout	string	La disposition des canaux.	stereo
Timebase	string	La base de temps.	1/44100
StartTime	string	L'heure de début, en secondes.	0.000000
Duration	string	La durée.	16.200998
Bitrate	string	Le débit binaire.	127.794
Fps	string	La fréquence d'images audio.	8
NumFrames	string	Le nombre total d'images.	10
Lang	string	La langue.	und
VideoStreamInfoList	array<object>	Les informations sur le flux vidéo. Une ressource multimédia peut contenir plusieurs flux vidéo.
	object
Index	string	L'index du flux vidéo.	0
CodecName	string	Le nom court du codec.	h264
CodecLongName	string	Le nom long du codec.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	Le profil d'encodage.	High
CodecTimeBase	string	La base de temps du codec.	1/48
CodecTagString	string	La chaîne de balise du codec.	[0][0][0][0]
CodecTag	string	La balise du codec.	0x0000
Width	string	La largeur.	960
Height	string	La hauteur.	540
HasBFrames	string	Indique si des images B sont présentes.	2
Sar	string	Le rapport d'aspect des échantillons.	0:1
Dar	string	Le rapport d'aspect d'affichage.	0:1
PixFmt	string	Le format de pixel.	yuv420p
Level	string	Le niveau d'encodage.	30
Fps	string	La fréquence d'images vidéo.	24.0
AvgFPS	string	La fréquence d'images moyenne.	24.0
Timebase	string	La base de temps.	1/12288
StartTime	string	L'heure de début, en secondes.	0.081706
Duration	string	La durée.	216.206706
Bitrate	string	Le débit binaire.	1001.594
NumFrames	string	Le nombre total d'images.	5184
Lang	string	La langue.	und
Rotate	string	La rotation.	0
Nb_frames	string	Le nombre total d'images.	5184
SubtitleStreamInfoList	array<object>	Les informations sur le flux de sous-titres. Un média peut contenir plusieurs flux de sous-titres.
	object
Index	string	L'index du flux de sous-titres.	1
CodecName	string	Le nom court du codec.	srt
CodecLongName	string	Le nom long du codec.	SubRip Text
CodecTimeBase	string	La base de temps du codec.	29.97
CodecTagString	string	La chaîne de balise du codec.	unicode
CodecTag	string	La balise du codec.	unicode
Timebase	string	La base de temps.	30
StartTime	string	L'heure de début, en secondes.	0
Duration	string	La durée.	1
Lang	string	La langue.	und
AiRoughData	object	Les données brutes de l'analyse IA.
Result	string	Le résultat brut de l'analyse IA.	https://sample-bucket.cn-shanghai.aliyuncs.com/result.json
Status	string	L'état de l'analyse IA. Valeurs valides : Analyzing : l'analyse est en cours. AnalyzeSuccess : l'analyse a réussi. AnalyzeFailed : l'analyse a échoué. Saving : les données sont en cours d'enregistrement. SaveSuccess : les données ont été enregistrées avec succès. SaveFailed : l'enregistrement des données a échoué. Deleting : les données sont en cours de suppression. DeleteSuccess : les données ont été supprimées avec succès. DeleteFailed : la suppression des données a échoué.	Analyzing
SaveType	string	Le type de stockage. Indique si les données doivent être enregistrées dans la bibliothèque de recherche une fois l'analyse intelligente terminée. Valeurs valides : TEXT : la bibliothèque de texte.	TEXT
AiCategory	string	La catégorie IA. Valeurs valides : Daily life Appearance Cute pets News Advertising Environmental resources Automotive	Life
AiJobId	string	L'identifiant de la tâche IA.	**483915d4f2cd8ac20b48fb04**
StandardSmartTagJob	object	La tâche de balisage.
AiJobId	string	L'identifiant de la tâche IA.	**483915d4f2cd8ac20b48fb04**
Status	string	L'état de l'analyse IA. Valeurs valides : Analyzing : l'analyse est en cours. AnalyzeSuccess : l'analyse a réussi. AnalyzeFailed : l'analyse a échoué.	Analyzing
ResultUrl	string	L'URL du résultat de balisage.	http://xx.oss-cn-shanghai.aliyuncs.com/result2.txt
Results	array<object>	La liste des résultats de reconnaissance de balises.
	object	Le résultat de reconnaissance de balises.
Data	string	Les données spécifiques du résultat d'analyse, représentées sous forme de chaîne JSON. Pour les structures de données de différents types, consultez Description du paramètre Result.	{"autoChapters": [...]}
Type	string	Le type de reconnaissance de balises. Valeurs valides : NLP : le résultat du traitement NLP. TextLabel : la balise de texte. VideoLabel : la balise vidéo. ASR : le résultat brut de la reconnaissance vocale. OCR : le résultat brut de la reconnaissance de texte.	NLP

Exemples

JSON format

{
  "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": "Tag,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"
          }
        ]
      }
    }
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.