Tous les produits
Search

Ce produit

    :ProduceEditingProjectVideo

    Centre de documentation

    :ProduceEditingProjectVideo

    Dernière mise à jour :Aug 05, 2026

    Produit une vidéo finale à partir d'une ou plusieurs vidéos. Vous pouvez soumettre les vidéos sources directement via le paramètre Timeline, ou créer d'abord un projet de montage en ligne puis le soumettre pour production.

    Description de l'opération

    • Avant d'utiliser cette opération, assurez-vous de bien connaître les modes de facturation et la tarification d'ApsaraVideo VOD. Le montage en ligne est une fonctionnalité payante. Pour plus d'informations sur la facturation, consultez Facturation du montage et de la production vidéo.

    • Il s'agit d'une opération asynchrone. Après avoir soumis une tâche, l'identifiant du projet de montage en ligne est renvoyé (la vidéo n'a pas encore été produite et la tâche entre dans une file d'attente pour une exécution asynchrone). Le résultat final est envoyé via une notification de rappel. Vous pouvez également appeler GetEditingProject pour interroger l'état de la tâche.

    • Les ressources vidéo utilisées dans la timeline du projet de montage en ligne peuvent provenir de la bibliothèque de ressources ou de la bibliothèque multimédia. Si vous utilisez des vidéos de la bibliothèque multimédia, assurez-vous que leur état est Normal.

    • Les vidéos sont produites en fonction de ProjectId et Timeline. La logique est la suivante :

      • ProjectId et Timeline ne peuvent pas être vides simultanément. Sinon, il n'existe aucune base pour produire des vidéos.

      • Si ProjectId est vide et que Timeline ne l'est pas, un projet de montage en ligne est automatiquement créé avec la Timeline spécifiée. Les ressources référencées dans la Timeline sont extraites et définies comme ressources du projet. Ensuite, la production vidéo commence.

      • Si ProjectId n'est pas vide et que Timeline est vide, la Timeline enregistrée la plus récente est récupérée en fonction de ProjectId et utilisée pour produire les vidéos.

      • Si ProjectId et Timeline ne sont pas vides, la Timeline spécifiée est utilisée pour produire les vidéos, et le projet de montage en ligne correspondant est mis à jour (Timeline et ressources du projet). Si d'autres champs sont spécifiés, les champs de projet correspondants sont également mis à jour.

    • Le nombre maximal de pistes pour les pistes vidéo, les pistes d'images et les pistes de sous-titres est de 100 pour chacune.

    • Le nombre total de ressources ne peut pas dépasser 200, et la taille totale des fichiers des ressources ne peut pas dépasser 1 To.

    • La région du bucket d'entrée ou de sortie doit être identique à la région où le service ApsaraVideo VOD est utilisé.

    • Lorsque la sortie est une vidéo, les limites de résolution suivantes s'appliquent à la vidéo finale :

      • La largeur et la hauteur doivent être d'au moins 128 px.

      • La largeur et la hauteur doivent être d'au plus 4096 px.

      • Le côté le plus court doit être d'au plus 2160 px.

    • Une fois la production vidéo terminée, la vidéo est automatiquement importée dans ApsaraVideo VOD. Par conséquent, après la fin de la production vidéo, ApsaraVideo VOD envoie les notifications d'événement ProduceMediaComplete et FileUploadComplete. Une fois le transcodage de la vidéo produite terminé, les notifications d'événement single definition video transcoding complete et all definition video transcoding complete sont envoyées.

    • Vous pouvez également ajouter des effets à la vidéo produite. Pour plus de détails, consultez Effets.

    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.

    vod:ProduceEditingProjectVideo

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    ProjectId

    string

    Non

    L'identifiant du projet de montage en ligne. Vous pouvez obtenir cet identifiant en utilisant l'une des méthodes suivantes :

    • Connectez-vous à la console ApsaraVideo VOD, choisissez Centre de production > Montage vidéo, et consultez l'identifiant.

    • Obtenez la valeur du paramètre ProjectId renvoyée lors de l'appel de l'opération CreateEditingProject.

    fb2101bf24b4cb318787dc****
    Timeline

    string

    Non

    La timeline du projet de montage en ligne au format JSON. Pour plus d'informations sur la structure, consultez Timeline.

    Remarque

    Assurez-vous que chaque objet VideoTrackClip contient un MediaId valide. Sinon, la requête échoue.

    {"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]}
    Title

    string

    Non

    Le titre du projet de montage en ligne.

    Titre du projet de montage en ligne
    Description

    string

    Non

    La description du projet de montage en ligne.

    Description du projet de montage en ligne
    CoverURL

    string

    Non

    La miniature du projet de montage en ligne.

    https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png
    MediaMetadata

    string

    Non

    Les métadonnées de la vidéo produite au format JSON. Pour plus d'informations sur la structure, consultez MediaMetadata.

    {"Description":"Description de la vidéo de synthèse","Title":"Test userData de synthèse"}
    ProduceConfig

    string

    Non

    La configuration de production au format JSON. Pour plus d'informations sur la structure, consultez ProduceConfig.

    Important Le champ StorageLocation peut être ignoré lorsque la région de stockage des fichiers est Shanghai. Il est requis lorsque la région de stockage des fichiers se trouve dans d'autres régions.

    {"TemplateGroupId":"6d11e25ea30a4c465435c74****"}
    UserData

    string

    Non

    Les paramètres personnalisés au format JSON. La longueur maximale est de 256 caractères. Les paramètres prennent en charge les rappels de messages et d'autres configurations. Pour plus d'informations sur la structure, consultez UserData.

    Remarque

    Pour utiliser le rappel de message dans ce paramètre, configurez l'URL de rappel HTTP et sélectionnez les types d'événements de rappel correspondants dans la console. Sinon, les paramètres de rappel ne prennent pas effet.

    {"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}
    AppId

    string

    Non

    L'identifiant de l'application. Valeur par défaut : app-1000000. Pour plus d'informations, consultez Multi-application.

    app-****

    É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.

    25818875-5F78-4AF6-D7393642CA58****
    MediaId

    string

    L'identifiant de la vidéo produite.

    Remarque

    • L'opération de production vidéo renvoie de manière synchrone l'identifiant de la vidéo produite.

    • Lorsque MediaId est renvoyé, la production vidéo est entrée dans la phase de traitement asynchrone.

    006204a11bb386bb25491f95f****
    ProjectId

    string

    L'identifiant du projet de montage en ligne.

    fb2101bf24b4cb318787dc****

    Exemples

    JSON format

    {
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "MediaId": "006204a11bb386bb25491f95f****",
  "ProjectId": "fb2101bf24b4cb318787dc****"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.