SubmitTranscodeJobs - - Centre de documentation Alibaba Cloud

Remarque

Le transcodage d'une vidéo n'est possible que si celle-ci se trouve dans l'état UploadSucc, Normal ou Checking.
Récupérez le résultat du transcodage via la notification d'événement StreamTranscodeComplete ou TranscodeComplete.
Si vous initiez une tâche d'empaquetage HTTP Live Streaming (HLS), appelez cette opération pour remplacer dynamiquement les sous-titres. Si la tâche d'empaquetage ne contient pas de sous-titres, nous vous déconseillons d'utiliser cette opération pour lancer l'empaquetage. Spécifiez plutôt l'ID du groupe de modèles lors du chargement de la vidéo. Le processus d'empaquetage se lance alors automatiquement.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	SubmitTranscodeJobs	L'opération à effectuer. Définissez la valeur sur SubmitTranscodeJobs.
TemplateGroupId	String	Oui	ea2727ecc0*****5ff43c04878f4e1	L'ID du groupe de modèles de transcodage utilisé lors du transcodage de la vidéo. Pour spécifier un groupe de modèles de transcodage, connectez-vous à la console ApsaraVideo VOD et consultez l'ID du groupe de modèles de transcodage sur la page Transcode.
VideoId	String	Non	0222e203cf*****72f9c22870a4d2c	L'ID de la vidéo. Remarque Le paramètre VideoId est obligatoire.
PipelineId	String	Non	d3e680e618708*****fbf2cae7cc931	L'ID du pipeline.
EncryptConfig	String	Non	{"CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt", "DecryptKeyUri":"http://decrypt.demo.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt","KeyServiceType":"KMS"}	Les configurations de chiffrement. La valeur est une chaîne au format JSON. Ce paramètre n'est requis que lors de l'utilisation du chiffrement HLS. Remarque Dans la chaîne JSON du paramètre EncryptConfig, définissez le paramètre CipherText sur une clé de texte chiffré AES-128 générée en appelant l'opération GenerateDataKey. Sinon, la tâche de transcodage utilisant le chiffrement HLS échouera. Pour plus d'informations sur l'utilisation du chiffrement HLS, consultez la rubrique Chiffrement HLS. Que le chiffrement HLS ou la cryptographie propriétaire Alibaba Cloud soit requis, activez le chiffrement HLS pour le groupe de modèles spécifié par le paramètre TemplateGroupId. Sinon, le chiffrement HLS ne peut pas être utilisé.
OverrideParams	String	Non	{"Watermarks":[{"WatermarkId":"af2afe4761992c***47dae97337","FileUrl":"http://test.bucket.aliyuncs.com/image/replace.png"},{"WatermarkId":"e8e5b8038d7a***da85b376c270","Content":"Watermark test"}]}	Les paramètres de remplacement. La valeur est une chaîne au format JSON. Utilisez ce paramètre pour remplacer le filigrane ou le sous-titre associé au modèle de transcodage. Vous pouvez remplacer l'URL du fichier d'un filigrane image, le contenu d'un filigrane textuel, l'URL d'un fichier de sous-titres et le format d'encodage d'un fichier de sous-titres. Pour plus d'informations sur la structure des données, consultez la section « OverrideParams » de la rubrique Paramètres de traitement des médias.
Priority	String	Non	6	La priorité de la tâche de transcodage actuelle parmi toutes les tâches en file d'attente. Valeurs valides : 1 à 10. Une valeur de 10 indique la priorité la plus élevée. Valeur par défaut : 6. Remarque Ce paramètre spécifie la priorité de la tâche de transcodage actuelle uniquement parmi toutes les tâches en file d'attente et n'affecte pas les priorités des tâches en cours d'exécution.
UserData	String	Non	{"Extend":{"localId":"**","test":"*"}}	Les configurations personnalisées, y compris les configurations de rappel. La valeur est une chaîne au format JSON. Pour plus d'informations, consultez la section « UserData » de la rubrique Paramètres de requête. Remarque Les configurations de rappel prennent effet uniquement lorsque vous spécifiez une URL de rappel HTTP et sélectionnez des événements de rappel spécifiques dans la console ApsaraVideo VOD.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	B1DBEFB3-3371-4E*****43-708259D719CE	L'ID de la requête.
TranscodeJobs	Array of TranscodeJob		Les tâches de transcodage. Remarque Ce paramètre n'est pas renvoyé pour les tâches d'empaquetage HLS. Vous devez recevoir le résultat du transcodage de manière asynchrone.
TranscodeJob
JobId	String	d8921ce85057*****16cfe86fb112c	L'ID de la tâche.
TranscodeTaskId	String	9f4a0df7da2c*****8a81c8c0408c8	L'ID de la tâche de transcodage soumise.

Exemples

Exemples de requêtes

https://vod.{ApiRegion}.aliyuncs.com/?Action=SubmitTranscodeJobs
&TemplateGroupId=ea2727ecc0*****5ff43c04878f4e1
&<Common request parameters>

Exemples de réponses réussies

Format XML

<SubmitTranscodeJobsResponse>
  <RequestId>B1DBEFB3-3371-4E*****43-708259D719CE</RequestId>
  <TranscodeJobs>
        <TranscodeJob>
              <JobId>d8921ce85057*****16cfe86fb112c</JobId>
        </TranscodeJob>
  </TranscodeJobs>
  <TranscodeTaskId>9f4a0df7da2c*****8a81c8c0408c8</TranscodeTaskId>
</SubmitTranscodeJobsResponse>

Format JSON

{
    "RequestId": "B1DBEFB3-3371-4E*****43-708259D719CE",
    "TranscodeJobs": {
        "TranscodeJob": [
            {
                "JobId": "d8921ce85057*****16cfe86fb112c"
            }
        ]
    },
    "TranscodeTaskId": "9f4a0df7da2c*****8a81c8c0408c8"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.

Erreurs courantes

Le tableau suivant décrit les erreurs courantes que cette opération peut renvoyer.

Code d'erreur	Message d'erreur	Code d'état HTTP	Description
InvalidVideo.NotFound	The video does not exist.	404	L'erreur indiquée signifie que la vidéo n'existe pas.
NoSuchResource	The specified resource %s does not exist.	404	L'erreur indiquée signifie que la ressource liée à l'utilisateur n'existe pas. %s indique les informations spécifiques sur la ressource.
Forbidden.IllegalStatus	Status of the video is illegal.	400	L'erreur indiquée signifie que l'état de la vidéo est invalide. Le transcodage d'une vidéo n'est possible que si celle-ci se trouve dans l'état UploadSucc, Normal ou Checking.

Exemples de SDK

Nous vous recommandons d'utiliser un SDK serveur pour appeler cette opération. Pour plus d'informations sur les exemples de code utilisés pour appeler cette opération dans différents langages, consultez les rubriques suivantes :