ProduceEditingProjectVideo - - Centre de documentation Alibaba Cloud

Génère une vidéo à partir d'un ou plusieurs fichiers mezzanine. Vous pouvez soumettre directement les fichiers mezzanine en spécifiant le paramètre Timeline, ou les soumettre après avoir créé un projet de montage en ligne.

Remarque

Cette opération renvoie uniquement le résultat de la soumission d'une tâche de production vidéo. La production peut être toujours en cours lorsque ce résultat est renvoyé. Une fois soumise, la tâche est placée en file d'attente pour un traitement asynchrone en arrière-plan.
- Les fichiers mezzanine référencés dans la timeline d'un projet de montage en ligne peuvent provenir des ressources multimédias ou des vidéos de la bibliothèque multimédia.
La production vidéo s'appuie sur les paramètres ProjectId et Timeline. Respectez les consignes suivantes lors de leur spécification :
- Spécifiez au moins l'un des paramètres ProjectId ou Timeline. À défaut, la production vidéo échoue.
- Si vous spécifiez uniquement le paramètre Timeline, le système crée automatiquement un projet de montage en ligne avec la timeline indiquée. Il récupère ensuite les fichiers mezzanine référencés dans cette timeline et génère la vidéo correspondante.
- Si vous spécifiez uniquement le paramètre ProjectId, le système récupère la dernière timeline du projet indiqué et produit la vidéo associée.
- Si vous spécifiez les deux paramètres ProjectId et Timeline, le système produit la vidéo selon la timeline indiquée et met à jour la timeline ainsi que les fichiers mezzanine du projet de montage en ligne concerné. Toute autre paramètre spécifié entraîne également la mise à jour des paramètres associés du projet.
- Vous pouvez appliquer des effets à la vidéo à produire. Pour plus d'informations, consultez la rubrique Effets spéciaux.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil 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	ProduceEditingProjectVideo	Opération à effectuer. Définissez la valeur sur ProduceEditingProjectVideo.
ProjectId	String	Non	fb2101bf24b*****4cb318787dc	ID du projet de montage en ligne.
Timeline	String	Non	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac5***9615a54328bc3443"},{"MediaId":"da87a9cff64***5cd88bc6d8326e4"}]}]}	Timeline du projet de montage en ligne, au format JSON. Pour plus d'informations sur la structure, consultez la rubrique Timeline.
Title	String	Non	Test of video production	Titre du projet de montage en ligne.
Description	String	Non	Description	Description du projet de montage en ligne.
CoverURL	String	Non	https://**.com/6AB4D0E1E1C7446888351**.png	URL de la vignette du projet de montage en ligne.
MediaMetadata	String	Non	{"Description": "Description of the produced video", "Title": "User data-based production test"}	Métadonnées de la vidéo produite, au format JSON. Pour plus d'informations sur la structure, consultez la rubrique MediaMetadata.
ProduceConfig	String	Non	{"TemplateGroupId":"6d11e25ea30a*****4c465435c74"}	Configuration de la production vidéo, au format JSON. Pour plus d'informations sur la structure, consultez la rubrique ProduceConfig.
UserData	String	Non	{"Extend":{"width":1280,"id":"028a8e56b*****1ebf6bb7afc74","height":720},"MessageCallback":{"CallbackURL":"https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}	Configuration personnalisée, telle que la configuration de rappel. La valeur est une chaîne au format JSON. Pour plus d'informations sur la structure, consultez la rubrique UserData. Remarque Pour utiliser le paramètre MessageCallback, définissez une URL de rappel HTTP et sélectionnez un type d'événement de rappel dans la console ApsaraVideo VOD. À défaut, la configuration de rappel ne prend pas effet.

Paramètres de réponse

Paramètre	Type	Exemple	Description
MediaId	String	006204a11bb3*****86bb25491f95f	ID de la vidéo produite. Remarque Cette opération renvoie l'ID de la vidéo produite en mode synchrone. Si cette opération renvoie le paramètre MediaId, la tâche de production vidéo est en cours de traitement asynchrone.
ProjectId	String	fb2101bf24b*****4cb318787dc	ID du projet de montage en ligne.
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID de la requête.

Remarque

ApsaraVideo VOD envoie une notification d'événement FileUploadComplete une fois la production vidéo terminée, comme après le téléchargement d'une vidéo. Une fois la vidéo produite transcodée, ApsaraVideo VOD envoie les notifications d'événement StreamTranscodeComplete et TranscodeComplete.

Exemples

Exemples de requêtes

https://vod.{ApiRegion}.aliyuncs.com/?Action=ProduceEditingProjectVideo
&<Common request parameters>

Exemples de réponses réussies

XML format

<ProduceEditingProjectVideoResponse>
      <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
      <MediaId>006204a11bb3*****86bb25491f95f</MediaId>
      <ProjectId>fb2101bf24b*****4cb318787dc</ProjectId>
</ProduceEditingProjectVideoResponse>

JSON format

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
    "MediaId": "006204a11bb3*****86bb25491f95f",
    "ProjectId":"fb2101bf24b*****4cb318787dc"
}

Codes d'erreur

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

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 :