SubmitAnalysisJob - - Centre de documentation Alibaba Cloud

Soumet une tâche d'analyse de modèle prédéfini.

Description de l'opération

Après avoir soumis une tâche en appelant cette opération, ApsaraVideo Media Processing analyse intelligemment le fichier d'entrée et recommande des modèles prédéfinis adaptés à ce fichier. Vous pouvez obtenir le résultat de la tâche d'analyse de modèle en appelant l'opération Interroger les tâches d'analyse de modèle, ou utiliser le mécanisme de notification asynchrone.
Les résultats de l'analyse des modèles prédéfinis ne sont conservés que pendant 15 jours à compter de leur génération. Passé ce délai, les résultats sont supprimés. Si vous utilisez un modèle prédéfini recommandé pour soumettre une tâche après ces 15 jours, la tâche de transcodage échoue et le code d'erreur AnalysisResultNotFound est renvoyé.

Limites de QPS

La limite de QPS pour un utilisateur unique est de 100 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Effectuez les appels d'API à un rythme raisonnable. Pour plus d'informations, consultez Limites de QPS.

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:SubmitAnalysisJob

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, qui est un objet JSON. Vous devez accorder les autorisations de lecture sur le bucket à ApsaraVideo Media Processing sur la page d'autorisation du bucket dans la console OSS. Pour plus d'informations, consultez Détails des paramètres. Remarque La région du bucket OSS doit être identique à la région de MPS.	{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}
AnalysisConfig	string	Non	La configuration de la tâche d'analyse de modèle. Définissez les paramètres selon vos besoins. Pour plus d'informations, consultez Détails des paramètres.	{"QualityControl":{"RateQuality":25,"MethodStreaming":"network"}}
UserData	string	Non	Les données utilisateur personnalisées. Elles peuvent contenir des caractères chinois et anglais, des chiffres et des traits d'union (-). Elles ne peuvent pas commencer par un caractère spécial. La longueur maximale est de 1 024 octets.	testid-001
PipelineId	string	Oui	L'identifiant de la file d'attente MPS. Vous pouvez consulter cet identifiant en choisissant Console MPS > Paramètres globaux > Pipelines. Si une notification asynchrone est requise, assurez-vous qu'un sujet de message disponible est lié à cette file d'attente MPS.	bb558c1cc25b45309aab5be44d19****
Priority	string	Non	La priorité de transcodage de la tâche dans sa file d'attente MPS correspondante. Valeurs valides : [1,10]. Une valeur de 10 indique la priorité la plus élevée. Valeur par défaut : 6.	10

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	B52658D4-07AB-43CD-82B0-210958A65E23
AnalysisJob	object	La tâche d'analyse de modèle pour les modèles prédéfinis du système.
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
Percent	integer	La progression du transcodage.	100
State	string	L'état de la tâche. Valeurs valides : Submitted : La tâche est soumise. Analyzing : La tâche est en cours d'analyse. Success : L'analyse a réussi. Fail : L'analyse a échoué.	Success
AnalysisConfig	object	La configuration de la tâche.
QualityControl	object	Le contrôle de la qualité de sortie.
MethodStreaming	string	La méthode de lecture. Valeurs valides : network : En ligne. local : Local. Valeur par défaut : network.	network
RateQuality	string	Le niveau de qualité de sortie.	50
PropertiesControl	object	Le contrôle des propriétés.
Deinterlace	string	La détermination du mode de balayage forcé. Valeurs valides : Auto : Automatique. Force : Désentrelacement forcé. None : Aucun désentrelacement forcé.	Force
Crop	object	La configuration de recadrage vidéo.
Top	string	La marge supérieure pour le recadrage. Remarque Si Mode est défini sur Auto ou None, cette valeur ne prend pas effet.	8
Width	string	La largeur après recadrage. Remarque Si Mode est défini sur Auto ou None, cette valeur ne prend pas effet.	8
Height	string	La hauteur après recadrage. Remarque Si Mode est défini sur Auto ou None, cette valeur ne prend pas effet.	8
Left	string	La marge gauche pour le recadrage. Remarque Si Mode est défini sur Auto ou None, cette valeur ne prend pas effet.	8
Mode	string	La méthode de recadrage. Valeurs valides : Auto : Automatique. Il s'agit de la valeur par défaut. Force : Forcé. None : Aucun recadrage forcé.	Auto
Message	string	Le message d'erreur renvoyé lorsque l'analyse échoue.	The resource operated \"PipelineId\" cannot be found
Priority	string	La priorité de la tâche dans la file d'attente MPS correspondante. Valeurs valides : [1,10]. Une valeur de 10 indique la priorité la plus élevée. Valeur par défaut : 10.	10
MNSMessageResult	object	Le résultat de la notification MNS envoyée à l'utilisateur lorsque la tâche est terminée.
MessageId	string	L'identifiant du message renvoyé lorsque l'analyse réussit. Ce paramètre n'est pas renvoyé lorsque l'analyse échoue.	3ca84a39a9024f19853b21be9cf9****
ErrorMessage	string	Le message d'erreur renvoyé lorsque l'analyse échoue. Ce paramètre n'est pas renvoyé lorsque l'analyse réussit.	The resource operated \"PipelineId\" cannot be found
ErrorCode	string	Le code d'erreur renvoyé lorsque l'analyse échoue. Ce paramètre n'est pas renvoyé lorsque l'analyse réussit.	InvalidParameter.ResourceNotFound
TemplateList	object
Template	array<object>	La liste des modèles prédéfinis générés par la tâche.
	array<object>	Les détails des modèles prédéfinis générés par la tâche.
Video	object	La configuration du codec vidéo.
Bufsize	string	La taille de la mémoire tampon. Unité : Kb. Valeur par défaut : 6000.	5000
Degrain	string	L'intensité de l'algorithme indépendant de réduction du bruit.	5
BitrateBnd	object	La plage de débit binaire vidéo moyen.
Max	string	La limite supérieure du débit binaire total. Unité : Kbps.	20
Min	string	La limite inférieure du débit binaire total. Unité : Kbps.	10
PixFmt	string	Le format de couleur vidéo. Les formats de couleur standard tels que yuv420p et yuvj420p sont pris en charge.	yuvj420p
Codec	string	Le format de codec. Valeur par défaut : H.264.	H.264
Height	string	La hauteur de la vidéo. Unité : px. Valeur par défaut : Hauteur de la vidéo d'origine.	1880
Qscale	string	Le niveau de contrôle de la qualité vidéo.	15
Bitrate	string	Le débit binaire vidéo moyen. Unité : Kbps.	10
Maxrate	string	Le débit binaire vidéo de crête. Unité : Kbps.	10
Profile	string	Le profil d'encodage. Valeurs valides : baseline : Pour les appareils shift. main : Pour les appareils à résolution standard. high : Pour les appareils à haute résolution. Valeur par défaut : high.	baseline
Crf	string	Le facteur de débit constant (CRF) pour le contrôle du débit binaire et de la qualité. Valeur par défaut : Si le format d'encodage est H.264, la valeur par défaut est 23. Si le format d'encodage est H.265, la valeur par défaut est 26. Si Crf est défini, le paramètre Bitrate ne prend pas effet.	27
Gop	string	Le nombre maximal d'images entre les images clés. Valeur par défaut : 250.	1
Width	string	La largeur de la vidéo. Unité : px. Valeur par défaut : Largeur de la vidéo d'origine.	1990
Fps	string	La fréquence d'images. Si la fréquence d'images du fichier d'entrée dépasse 60, la valeur 60 est utilisée. Valeur par défaut : Fréquence d'images du fichier d'entrée.	60
Preset	string	Le préréglage de l'algorithme vidéo. Valeurs valides : veryfast, fast, medium, slow et slower. Valeur par défaut : medium.	medium
ScanMode	string	Le mode de balayage. Valeurs valides : interlaced : Balayage entrelacé. progressive : Balayage progressif.	progressive
TransConfig	object	La configuration générale de transcodage.
TransMode	string	Le mode de transcodage. Valeurs valides : onepass, twopass et CBR. Valeur par défaut : onepass.	onepass
State	string	L'état du modèle. Valeurs valides : Normal : Normal. Deleted : Supprimé.	Normal
MuxConfig	object	La configuration de multiplexage de transcodage.
Gif	object	Le format GIF.
FinalDelay	string	L'intervalle de boucle du GIF. Unité : centièmes de seconde. Par exemple, 500 indique un intervalle de 5 secondes.	0
Loop	string	Le nombre de boucles pour GIF et WebP. Par défaut, aucune boucle n'est effectuée.	0
Segment	object	La configuration des segments.
Duration	string	La durée du segment. Unité : secondes.	60
Name	string	Le nom du modèle.	FLV-UD
Audio	object	La configuration du codec audio.
Profile	string	Le préréglage d'encodage audio. Lorsque Codec est défini sur aac, les valeurs valides sont aac_low, aac_he, aac_he_v2, aac_ld et aac_eld.	aac_low
Codec	string	Le format de codec audio. Valeur par défaut : aac.	mp3
Samplerate	string	La fréquence d'échantillonnage. Unité : Hz. Valeur par défaut : 44100.	32000
Qscale	string	Le niveau de contrôle de la qualité audio.	10
Channels	string	Le nombre de canaux audio. Valeur par défaut : 2.	1
Bitrate	string	Le débit binaire audio du fichier de sortie. Unité : Kbps. Valeur par défaut : 128.	8
Id	string	L'identifiant du modèle de transcodage.	S00000000-00****
Container	object	Le conteneur.
Format	string	Le format de conteneur.	flv
UserData	string	Les données définies par l'utilisateur.	testid-001
Code	string	Le code d'erreur renvoyé lorsque l'analyse échoue. Ce paramètre n'est pas renvoyé lorsque l'analyse réussit.	InvalidParameter.ResourceNotFound
InputFile	object	L'entrée de la tâche.
Object	string	L'objet OSS.	example.flv
Location	string	La région OSS.	oss-cn-hangzhou
Bucket	string	Le bucket OSS.	example-bucket
PipelineId	string	L'identifiant de la file d'attente MPS.	bb558c1cc25b45309aab5be44d19****
Id	string	L'identifiant de la tâche d'analyse de modèle.	57f6aa3f84824309bcba67231b40****

Exemples

JSON format

{
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A65E23",
  "AnalysisJob": {
    "CreationTime": "2014-01-10T12:00:00Z",
    "Percent": 100,
    "State": "Success",
    "AnalysisConfig": {
      "QualityControl": {
        "MethodStreaming": "network",
        "RateQuality": "50"
      },
      "PropertiesControl": {
        "Deinterlace": "Force",
        "Crop": {
          "Top": "8",
          "Width": "8",
          "Height": "8",
          "Left": "8",
          "Mode": "Auto"
        }
      }
    },
    "Message": "La ressource sur laquelle porte l'opération \\\"PipelineId\\\" est introuvable",
    "Priority": "10",
    "MNSMessageResult": {
      "MessageId": "3ca84a39a9024f19853b21be9cf9****",
      "ErrorMessage": "La ressource sur laquelle porte l'opération \\\"PipelineId\\\" est introuvable",
      "ErrorCode": "InvalidParameter.ResourceNotFound"
    },
    "TemplateList": {
      "Template": [
        {
          "Video": {
            "Bufsize": "5000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "20",
              "Min": "10"
            },
            "PixFmt": "yuvj420p",
            "Codec": "H.264",
            "Height": "1880",
            "Qscale": "15",
            "Bitrate": "10",
            "Maxrate": "10",
            "Profile": "baseline",
            "Crf": "27",
            "Gop": "1",
            "Width": "1990",
            "Fps": "60",
            "Preset": "medium",
            "ScanMode": "progressive"
          },
          "TransConfig": {
            "TransMode": "onepass"
          },
          "State": "Normal",
          "MuxConfig": {
            "Gif": {
              "FinalDelay": "0",
              "Loop": "0"
            },
            "Segment": {
              "Duration": "60"
            }
          },
          "Name": "FLV-UD",
          "Audio": {
            "Profile": "aac_low",
            "Codec": "mp3",
            "Samplerate": "32000",
            "Qscale": "10",
            "Channels": "1",
            "Bitrate": "8"
          },
          "Id": "S00000000-00****",
          "Container": {
            "Format": "flv"
          }
        }
      ]
    },
    "UserData": "testid-001",
    "Code": "InvalidParameter.ResourceNotFound",
    "InputFile": {
      "Object": "example.flv",
      "Location": "oss-cn-hangzhou",
      "Bucket": "example-bucket"
    },
    "PipelineId": "bb558c1cc25b45309aab5be44d19****",
    "Id": "57f6aa3f84824309bcba67231b40****"
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.