SubmitMediaInfoJob - ApsaraVideo Media Processing - Centre de documentation Alibaba Cloud

Soumet une tâche d'analyse des informations multimédias. Après l'appel de cette opération, ApsaraVideo Media Processing (MPS) analyse le fichier d'entrée et renvoie ses informations multimédias.

Description de l'opération

Assurez-vous que le fichier a été correctement chargé dans OSS avant de soumettre une tâche d'analyse des informations multimédias. Dans le cas contraire, la tâche échoue. Vous pouvez vérifier l'état de chargement du fichier en configurant les messages de rappel OSS.
Les tâches d'analyse des informations multimédias prennent en charge les modes synchrone et asynchrone.
Le mode asynchrone ne garantit pas les délais d'exécution. Une fois une tâche d'analyse des informations multimédias soumise, la tâche est ajoutée à une file d'attente MPS pour planification et exécution. Par conséquent, la tâche peut ne pas être générée au moment du retour de la réponse de l'API. Une fois l'exécution terminée, vous devez appeler l'opération Query media information analysis jobs pour interroger le résultat de l'exécution, ou lier un message MNS à la file d'attente MPS pour recevoir le résultat de l'exécution. Pour plus d'informations, consultez Receive message notifications.

Limite de QPS

La limite de requêtes par seconde (QPS) pour un seul utilisateur est de 50. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération de manière appropriée. Pour plus d'informations, consultez QPS limits.

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.

mts:SubmitMediaInfoJob

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Input	string	Oui	L'entrée de la tâche. Pour plus d'informations, consultez Input details. Remarque Dans les opérations de l'API ApsaraVideo Media Processing, le paramètre Object doit être encodé en URL en UTF-8 avant d'être utilisé. La région d'OSS doit être identique à la région de MPS.	{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}
UserData	string	Non	Les données utilisateur personnalisées. La valeur peut contenir des lettres, des chiffres et des traits d'union (-), et ne peut pas commencer par un caractère spécial. La longueur maximale est de 1 024 octets.	testid-001
PipelineId	string	Non	L'identifiant de la file d'attente MPS. Pour plus d'informations, consultez Terms. Valeurs valides : vous pouvez interroger et créer des files d'attente MPS en choisissant Paramètres globaux > Files d'attente MPS dans la console MPS. Si des notifications asynchrones sont requises, attachez un message MNS à la file d'attente MPS. Pour plus d'informations, consultez Accept message notifications.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Non	Indique si une tâche asynchrone doit être soumise. Valeurs valides : true : soumet une tâche asynchrone. Cette valeur est recommandée. false : ne soumet pas de tâche asynchrone.	true
Config	string	Non

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
MediaInfoJob	object	Les détails de la tâche d'analyse des informations multimédias.
CreationTime	string	L'heure à laquelle la tâche a été ajoutée. L'heure est affichée en UTC et suit la norme ISO 8601 au format AAAA-MM-JJTHH:mm:ssZ.	2014-01-10T12:00:00Z
State	string	L'état de la tâche. Valeurs valides : Success : la tâche a réussi. Fail : la tâche a échoué. Analyzing : la tâche est en cours d'analyse.	Analyzing
JobId	string	L'identifiant de la tâche d'analyse des informations multimédias.	23ca1d184c0e4341e5b665e2a12****
UserData	string	Les données utilisateur personnalisées.	testid-001
Code	string	Le code d'erreur renvoyé lorsque l'analyse des informations multimédias échoue.	InvalidParameter.JsonObjectFormatInvalid
Message	string	Le message d'erreur renvoyé lorsque l'analyse des informations multimédias échoue.	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	L'identifiant de la file d'attente MPS.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Indique si la tâche est asynchrone.	true
Input	object	Les informations d'entrée de la tâche.
Object	string	L'objet Object Storage Service (OSS) du fichier d'entrée.	example.flv
Location	string	La région du compartiment OSS qui stocke le fichier d'entrée.	example-location
Bucket	string	Le compartiment OSS qui stocke le fichier d'entrée.	example-bucket
MNSMessageResult	object	Le résultat de la notification Message Service (MNS) envoyée à l'utilisateur à la fin de la tâche.
MessageId	string	L'identifiant du message si la tâche réussit. Ce paramètre n'est pas renvoyé si la tâche échoue.	16f01ad6175e4230ac42bb5182cd****
ErrorMessage	string	Le message d'erreur si la tâche échoue. Ce paramètre n'est pas renvoyé si la tâche réussit.	InvalidParameter.JsonObjectFormatInvalid
ErrorCode	string	Le code d'erreur si la tâche échoue. Ce paramètre n'est pas renvoyé si la tâche réussit.	The parameter \"Input\" does not conform to the JSON Object specification
Properties	object	Les propriétés du fichier multimédia.
Width	string	La largeur de la vidéo. Unité : pixels.	1920
Height	string	La hauteur de la vidéo. Unité : pixels.	1080
Duration	string	La durée totale. Unité : secondes.	17.226000
Fps	string	La fréquence d'images.	25
Bitrate	string	Le débit binaire. Unité : Kbps.	1630.045
FileFormat	string	Le format de fichier.	QuickTime/MOV
Streams	object	Les informations de flux.
VideoStreamList	object
VideoStream	array<object>	La liste des flux vidéo. La liste contient jusqu'à quatre éléments.
	array<object>	Le flux vidéo.
Sar	string	Le rapport d'aspect de l'échantillon.	1:1
Height	string	La hauteur de la vidéo. Unité : pixels.	1080
CodecTagString	string	Le texte de la balise de format d'encodage.	avc1
NetworkCost	object	La consommation de bande passante réseau.
PreloadTime	string	Le temps de préchargement.	8
AvgBitrate	string	Le débit binaire moyen. Unité : Kbps.	300.34
CostBandwidth	string	La bande passante maximale consommée.	10
Width	string	La largeur de la vidéo. Unité : pixels.	1920
Index	string	L'index du flux vidéo. Cet index identifie la position du flux vidéo dans l'ensemble du flux multimédia. Certaines plateformes de lecture permettent de spécifier l'index du flux vidéo pour démarrer la lecture, tandis que d'autres démarrent la lecture à partir de l'index 1 par défaut.	1
Timebase	string	La base de temps.	1/24000
AvgFPS	string	La fréquence d'images moyenne.	23.976025
PixFmt	string	Le format de pixel.	yuv420p
Lang	string	La langue.	eng
CodecLongName	string	Le nom long du format d'encodage.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	Le nombre total d'images.	100
Rotate	string	L'angle de rotation de la vidéo.	90
Bitrate	string	Le débit binaire. Unité : Kbps.	1496.46
HasBFrames	string	Indique si la vidéo contient des images B. Une valeur de 0 indique l'absence d'images B. Une valeur de 1 indique que des images B sont incluses.	0
Profile	string	Le profil d'encodage.	High
StartTime	string	L'heure de début.	0.042000
Dar	string	Le rapport d'aspect d'affichage. Le rapport d'aspect d'affichage est calculé en divisant la largeur de la vidéo par sa hauteur. Vous pouvez utiliser cette valeur pour déterminer si la vidéo est en orientation paysage ou portrait.	16:9
CodecName	string	Le nom court du format d'encodage. Valeurs valides : h264 h265 gif webp	h264
Duration	string	La durée. Unité : secondes.	17.225542
Fps	string	La fréquence d'images.	25
CodecTag	string	La balise de format d'encodage.	0x31637661
CodecTimeBase	string	La base de temps du codec.	1001/48000
Level	string	Le niveau d'encodage.	41
ColorRange	string	La plage de couleurs.	700
ColorTransfer	string	Les caractéristiques de transfert de couleur.	R255 G83 B170
ColorPrimaries	string	Les couleurs primaires.	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	La liste des flux audio. La liste contient jusqu'à quatre éléments.
	object	Le flux vidéo.
Timebase	string	La base de temps.	1/44100
Index	string	L'index du flux audio. Cet index identifie la position du flux audio dans l'ensemble du flux multimédia.	1
SampleFmt	string	Le format d'échantillon.	fltp
ChannelLayout	string	La disposition des canaux.	stereo
Lang	string	La langue.	eng
Samplerate	string	La fréquence d'échantillonnage. Unité : Hz.	44100
CodecLongName	string	Le nom long du format d'encodage.	AAC (Advanced Audio Coding)
Channels	string	Le nombre de canaux.	2
NumFrames	string	Le nombre total d'images.	123
Bitrate	string	Le débit binaire. Unité : Kbps.	128.806
CodecTagString	string	Le texte de la balise de format d'encodage.	mp4a
StartTime	string	L'heure de début.	0.000000
CodecName	string	Le nom court du format d'encodage. Valeur par défaut : acc. Valeurs valides : acc mp3 mp4 ogg flac	aac
Duration	string	La durée. Unité : secondes.	17.159546
CodecTag	string	La balise de format d'encodage.	0x6134706d
CodecTimeBase	string	La base de temps du codec.	1/44100
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	La liste des flux de sous-titres. La liste contient jusqu'à quatre éléments.
	object	Le flux vidéo.
Timebase	string	La base de temps.	1/1000
Index	string	L'index du flux de sous-titres. Cet index identifie la position du flux de sous-titres dans l'ensemble du flux multimédia.	3
StartTime	string	L'heure de début.	0.000000
CodecName	string	Le nom court du format d'encodage. Valeurs valides : srt ass	ass
Lang	string	La langue.	eng
CodecLongName	string	Le nom long du format d'encodage.	ASS (Advanced SSA) subtitle
Duration	string	La durée. Unité : secondes.	1370.116000
CodecTag	string	La balise du format d'encodage.	0x0000
CodecTimeBase	string	La base de temps du codec.	0/1
CodecTagString	string	La chaîne de balises du format d'encodage.	[0][0][0][0]
Format	object	Les informations de format.
StartTime	string	L'heure de début.	0.000000
NumPrograms	string	Le nombre total de flux de programme.	0
Size	string	La taille du fichier, en octets.	3509895
NumStreams	string	Le nombre total de flux multimédias.	2
FormatLongName	string	Le nom long du format de conteneur ou d'empaquetage.	QuickTime/MOV
Duration	string	La durée totale. Unité : secondes.	17.226000
Bitrate	string	Le débit binaire total, en Kbit/s.	1630.045
FormatName	string	Le nom court du format de conteneur ou d'empaquetage. Pour plus d'informations, consultez Détails des paramètres.	mov
Tags	object
FileSize	string	La taille du fichier, en octets.	3509895
MD5	string
RequestId	string	L'identifiant de la requête.	62D9BE16-B7D5-550C-A482-7A0F60E09877

Exemples

JSON format

{
  "MediaInfoJob": {
    "CreationTime": "2014-01-10T12:00:00Z",
    "State": "Analyzing",
    "JobId": "23ca1d184c0e4341e5b665e2a12****",
    "UserData": "testid-001",
    "Code": "InvalidParameter.JsonObjectFormatInvalid",
    "Message": "Le paramètre « * » n'est pas conforme à la spécification JSON Object",
    "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
    "Async": true,
    "Input": {
      "Object": "example.flv",
      "Location": "example-location",
      "Bucket": "example-bucket"
    },
    "MNSMessageResult": {
      "MessageId": "16f01ad6175e4230ac42bb5182cd****",
      "ErrorMessage": "InvalidParameter.JsonObjectFormatInvalid",
      "ErrorCode": "Le paramètre « Input » n'est pas conforme à la spécification JSON Object"
    },
    "Properties": {
      "Width": "1920",
      "Height": "1080",
      "Duration": "17.226000",
      "Fps": "25",
      "Bitrate": "1630.045",
      "FileFormat": "QuickTime/MOV",
      "Streams": {
        "VideoStreamList": {
          "VideoStream": [
            {
              "Sar": "1:1",
              "Height": "1080",
              "CodecTagString": "avc1",
              "NetworkCost": {
                "PreloadTime": "8",
                "AvgBitrate": "300.34",
                "CostBandwidth": "10"
              },
              "Width": "1920",
              "Index": "1",
              "Timebase": "1/24000",
              "AvgFPS": "23.976025",
              "PixFmt": "yuv420p",
              "Lang": "eng",
              "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
              "NumFrames": "100",
              "Rotate": "90",
              "Bitrate": "1496.46",
              "HasBFrames": "0",
              "Profile": "High",
              "StartTime": "0.042000",
              "Dar": "16:9",
              "CodecName": "h264",
              "Duration": "17.225542",
              "Fps": "25",
              "CodecTag": "0x31637661",
              "CodecTimeBase": "1001/48000",
              "Level": "41",
              "ColorRange": "700",
              "ColorTransfer": "R255 G83 B170",
              "ColorPrimaries": "700",
              "DurationInaccurate": "",
              "DolbyVision": {
                "Profile": "",
                "Level": ""
              }
            }
          ]
        },
        "AudioStreamList": {
          "AudioStream": [
            {
              "Timebase": "1/44100",
              "Index": "1",
              "SampleFmt": "fltp",
              "ChannelLayout": "stereo",
              "Lang": "eng",
              "Samplerate": "44100",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "Channels": "2",
              "NumFrames": "123",
              "Bitrate": "128.806",
              "CodecTagString": "mp4a",
              "StartTime": "0.000000",
              "CodecName": "aac",
              "Duration": "17.159546",
              "CodecTag": "0x6134706d",
              "CodecTimeBase": "1/44100",
              "DurationInaccurate": ""
            }
          ]
        },
        "SubtitleStreamList": {
          "SubtitleStream": [
            {
              "Timebase": "1/1000",
              "Index": "3",
              "StartTime": "0.000000",
              "CodecName": "ass",
              "Lang": "eng",
              "CodecLongName": "Sous-titre ASS (Advanced SSA)",
              "Duration": "1370.116000",
              "CodecTag": "0x0000",
              "CodecTimeBase": "0/1",
              "CodecTagString": "[0][0][0][0]"
            }
          ]
        }
      },
      "Format": {
        "StartTime": "0.000000",
        "NumPrograms": "0",
        "Size": "3509895",
        "NumStreams": "2",
        "FormatLongName": "QuickTime/MOV",
        "Duration": "17.226000",
        "Bitrate": "1630.045",
        "FormatName": "mov",
        "Tags": {
          "test": "test",
          "test2": 1
        }
      },
      "FileSize": "3509895",
      "MD5": ""
    }
  },
  "RequestId": "62D9BE16-B7D5-550C-A482-7A0F60E09877"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.