SubmitMediaConvertJob - - Centre de documentation Alibaba Cloud

Soumet une tâche de traitement multimédia.

Description de l'opération

Il s'agit d'une opération asynchrone. Après la soumission d'une tâche, un identifiant de tâche est renvoyé. La tâche n'est pas encore terminée à ce stade et entre dans une file d'attente pour une exécution asynchrone en arrière-plan. Le résultat final est délivré via une notification de rappel. Vous pouvez également interroger de manière proactive l'état de la tâche en appelant Interroger la tâche de transcodage multimédia.

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

none

*All Resource

*

Aucune

Syntaxe de la requête

POST  HTTP/1.1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	La clé d'idempotence. Garantit l'idempotence de la requête.	86f8e525-9d73-4dac-88aa-7aa4e950c00a
Config	string	Oui	La configuration de la tâche de transcodage. Pour plus d'informations, consultez MediaConvertJobConfig.	{ "Inputs": [ { "InputFile": { "Type": "OSS", "Media": "http://.oss-cn-shanghai.aliyuncs.com/input//60min.mp4" } } ], "OutputGroups": [ { "GroupConfig": { "Type": "File", "OutputFileBase": { "Type": "OSS", "Media": "http://.oss-cn-shanghai.aliyuncs.com/output//" } }, "Outputs": [ { "OutputFile": "hd.mp4", "TemplateId": "S00000001-200030" }, { "OutputFile": "sd.mp4", "TemplateId": "S00000001-200020" } ] } ] }
UserData	string	Non	Les données utilisateur.	{"videoId":"abcd"}
PipelineId	string	Non	L'identifiant du pipeline.	e197ecfb103e4849922b054d3032f954

Éléments de réponse

Élément	Type	Description	Exemple
	object	Le résultat de la tâche de soumission d'un nœud de transcodage multimédia.
RequestId	string	L'identifiant de la requête.	****11-DB8D-4A9A-875B-275798****
Job	object	La tâche de transcodage multimédia.
RequestId	string	L'identifiant de la requête.	A2129C9F-CE95-58B5-B8C1-07758FF6C86F
ClientToken	string	Le paramètre d'idempotence pour la requête de création de la tâche de transcodage multimédia.	FB7F25E9-AD9B-1603-8AF6-F1E42DF2E706
JobId	string	L'identifiant de la tâche de transcodage multimédia.	**20b48fb04483915d4f2cd8ac**
Config	object	La configuration de la tâche de transcodage multimédia.
Inputs	array	The media transcoding task input list.
	MediaConvertInput	The media transcoding task input.	[{\"Src\":{\"Type\":\"MAP_SERVICE\",\"DataId\":\"479f6c63f66dcc1a9a09420fee32cbdf\",\"ZoomLevel\":18},\"Idx\":1}]
Outputs	array	The media transcoding output configuration list.
	MediaConvertOutput	The media transcoding task output configuration.	[]
OutputGroups	array	The media transcoding task output group configuration list.
	MediaConvertOutputGroup	The media transcoding task output group configuration.
JobName	string	The task name.	Name
PipelineId	string	L'identifiant du pipeline.	*48a4edf410b908aecd91fc3b*
UserData	string	Les données utilisateur.	{"videoId":"abcd"}
Code	string	Le code d'erreur renvoyé lorsque la tâche de transcodage multimédia échoue.	InvalidParameter.ResourceContentBad
Message	string	Le message d'erreur détaillé renvoyé lorsque la tâche de transcodage multimédia échoue.	La ressource traitée InputFile est incorrecte
State	string	L'état de la tâche de transcodage multimédia. Valeurs valides : Inited : initialisé. Running : en cours d'exécution. Success : transcodage réussi. Failed : échec du transcodage. Cancelled : annulé.	Success
OutputDetails	array	La liste des résultats de sortie du transcodage multimédia.
	MediaConvertOutputDetail	Le résultat de sortie du transcodage multimédia.
OutputGroupDetails	array	La liste des résultats de groupe de sortie du transcodage multimédia.
	MediaConvertOutputGroupDetail	Le résultat du groupe de sortie du transcodage multimédia.

Exemples

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Job": {
    "RequestId": "A2129C9F-CE95-58B5-B8C1-07758FF6C86F",
    "ClientToken": "FB7F25E9-AD9B-1603-8AF6-F1E42DF2E706",
    "JobId": "****20b48fb04483915d4f2cd8ac****",
    "Config": {
      "Inputs": [
        {
          "Name": "InputVideo",
          "InputFile": {
            "Type": "OSS",
            "Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
          }
        }
      ],
      "Outputs": [
        {
          "Name": "output-video",
          "OutputFile": {
            "Type": "OSS",
            "Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
          },
          "TemplateId": "****96e8864746a0b6f3****",
          "Priority": 6,
          "Features": "{}",
          "OverrideParams": "{}"
        }
      ],
      "OutputGroups": [
        {
          "Name": "hls-group",
          "GroupConfig": {
            "ManifestName": "manifest",
            "Type": "Hls",
            "OutputFileBase": {
              "Type": "OSS",
              "Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
            }
          },
          "Outputs": [
            {
              "Name": "group-output",
              "OutputFileName": "720p.mp4",
              "TemplateId": "****96e8864746a0b6f3****\n",
              "Priority": 6,
              "Features": "{}",
              "OverrideParams": "{}"
            }
          ]
        }
      ],
      "JobName": "Name"
    },
    "PipelineId": "***48a4edf410b908aecd91fc3b***",
    "UserData": "{\"videoId\":\"abcd\"}",
    "Code": "InvalidParameter.ResourceContentBad",
    "Message": "The resource operated InputFile is bad",
    "State": "Success",
    "OutputDetails": [
      {
        "Name": "720P-mp4",
        "TaskId": "******4215e042b3966ca5441e******",
        "Status": "Success",
        "Code": "InvalidParameter.ResourceContentBad\n",
        "Message": "The resource operated InputFile is bad\n",
        "Result": {
          "OutputFile": {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4\n",
            "Url": "oss://bucket/path/to/video.mp4"
          },
          "OutFileMeta": {
            "FileBasicInfo": {
              "MediaId": "9066406c306771f0bfa35107e0c90102",
              "FileName": "file.m3u8",
              "FileStatus": "Normal",
              "FileType": "source_file",
              "FileSize": "31737",
              "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
              "Region": "cn-shanghai",
              "FormatName": "hls,applehttp",
              "Duration": "403.039999",
              "Bitrate": "888.563",
              "Width": "848",
              "Height": "478"
            },
            "AudioStreamInfoList": [
              {
                "Index": "1",
                "CodecName": "aac",
                "CodecLongName": "AAC (Advanced Audio Coding)",
                "CodecTimeBase": "1/44100",
                "CodecTagString": "[15][0][0][0]",
                "CodecTag": "0x000f",
                "SampleFmt": "fltp",
                "SampleRate": "44100",
                "Channels": "2",
                "ChannelLayout": "stereo",
                "Timebase": "1/90000",
                "StartTime": "1.473556",
                "Duration": "403.039989",
                "Bitrate": "0.f",
                "Lang": "cn"
              }
            ],
            "VideoStreamInfoList": [
              {
                "Index": "0",
                "Codec_name": "h264",
                "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                "Profile": "High",
                "Codec_time_base": "1/50",
                "Codec_tag_string": "[27][0][0][0]",
                "Codec_tag": "0x001b",
                "Width": "848",
                "Height": "478",
                "Has_b_frames": "2",
                "Sar": "478:477",
                "Dar": "16:9",
                "PixFmt": "yuv420p",
                "Level": "31",
                "Fps": "25.0",
                "Avg_fps": "25.0",
                "Time_base": "1/90000",
                "Start_time": "1.473556",
                "Duration": "403.039989",
                "Bit_rate": "888.563",
                "NumFrames": "10040",
                "Lang": "cn",
                "Rotate": "0"
              }
            ]
          }
        },
        "CreateTime": "2024-12-07T06:06:58Z",
        "FinishTime": "2024-12-07T13:01:07Z"
      }
    ],
    "OutputGroupDetails": [
      {
        "Name": "hls-group",
        "TaskId": "******22dad741d086a50325f9******",
        "Code": "InvalidParameter.ResourceContentBad",
        "Message": "The resource operated \"InputFile\" is bad",
        "Status": "Success",
        "Outputs": [
          {
            "Name": "720P-mp4",
            "TaskId": "******4215e042b3966ca5441e******",
            "Status": "Success",
            "Code": "InvalidParameter.ResourceContentBad\n",
            "Message": "The resource operated InputFile is bad\n",
            "Result": {
              "OutputFile": {
                "Type": "OSS",
                "Media": "oss://bucket/path/to/video.mp4\n",
                "Url": "oss://bucket/path/to/video.mp4"
              },
              "OutFileMeta": {
                "FileBasicInfo": {
                  "MediaId": "9066406c306771f0bfa35107e0c90102",
                  "FileName": "file.m3u8",
                  "FileStatus": "Normal",
                  "FileType": "source_file",
                  "FileSize": "31737",
                  "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
                  "Region": "cn-shanghai",
                  "FormatName": "hls,applehttp",
                  "Duration": "403.039999",
                  "Bitrate": "888.563",
                  "Width": "848",
                  "Height": "478"
                },
                "AudioStreamInfoList": [
                  {
                    "Index": "1",
                    "CodecName": "aac",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "CodecTimeBase": "1/44100",
                    "CodecTagString": "[15][0][0][0]",
                    "CodecTag": "0x000f",
                    "SampleFmt": "fltp",
                    "SampleRate": "44100",
                    "Channels": "2",
                    "ChannelLayout": "stereo",
                    "Timebase": "1/90000",
                    "StartTime": "1.473556",
                    "Duration": "403.039989",
                    "Bitrate": "0.f",
                    "Lang": "cn"
                  }
                ],
                "VideoStreamInfoList": [
                  {
                    "Index": "0",
                    "Codec_name": "h264",
                    "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Profile": "High",
                    "Codec_time_base": "1/50",
                    "Codec_tag_string": "[27][0][0][0]",
                    "Codec_tag": "0x001b",
                    "Width": "848",
                    "Height": "478",
                    "Has_b_frames": "2",
                    "Sar": "478:477",
                    "Dar": "16:9",
                    "PixFmt": "yuv420p",
                    "Level": "31",
                    "Fps": "25.0",
                    "Avg_fps": "25.0",
                    "Time_base": "1/90000",
                    "Start_time": "1.473556",
                    "Duration": "403.039989",
                    "Bit_rate": "888.563",
                    "NumFrames": "10040",
                    "Lang": "cn",
                    "Rotate": "0"
                  }
                ]
              }
            },
            "CreateTime": "2024-12-07T06:06:58Z",
            "FinishTime": "2024-12-07T13:01:07Z"
          }
        ],
        "CreateTime": "2025-03-21T01:48:41Z",
        "FinishTime": "2025-03-21T01:48:41Z\n"
      }
    ]
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.