Tous les produits
Search

Ce produit

    :CreateUploadVideo

    Centre de documentation

    :CreateUploadVideo

    Dernière mise à jour :Aug 05, 2026

    ApsaraVideo VOD émet l'URL de téléversement et les informations d'identification de téléversement pour garantir l'autorisation et la sécurité, et empêcher les téléversements malveillants. Lors de l'émission, un identifiant de média (MediaId), également appelé identifiant de vidéo (VideoId), est automatiquement créé pour la gestion. Appelez cette opération pour obtenir l'URL de téléversement et les informations d'identification de téléversement, et créer des informations audio ou vidéo.

    Description de l'opération

    • Avant d'utiliser cette opération, assurez-vous de bien connaître les méthodes de facturation et les tarifs d'ApsaraVideo VOD. Le téléversement de fichiers multimédias vers ApsaraVideo VOD entraîne des frais de stockage. Pour plus d'informations, consultez Facturation du stockage des ressources multimédias. Si vous avez activé l'accélération du stockage et du transfert, le téléversement de fichiers multimédias vers ApsaraVideo VOD entraîne également des frais d'accélération de téléversement. Pour plus d'informations, consultez Facturation de l'accélération du stockage et du transfert. Les frais de stockage sont calculés à partir du moment où le fichier est téléversé. Les frais d'accélération sont calculés lorsque vous effectuez des opérations de téléversement après l'activation de la fonctionnalité. Le simple appel de cette opération n'entraîne aucun frais.

    • L'obtention de l'URL de téléversement et des informations d'identification est la base fondamentale d'ApsaraVideo VOD et constitue une étape obligatoire pour chaque opération de téléversement. ApsaraVideo VOD fournit plusieurs méthodes de téléversement, chacune ayant des exigences différentes pour l'obtention de l'URL de téléversement et des informations d'identification. Pour plus d'informations, consultez URL et informations d'identification de téléversement.

    • Cette opération est utilisée uniquement pour obtenir l'URL de téléversement et les informations d'identification, et pour créer des informations de base sur les ressources multimédias. Elle ne téléverse pas de fichiers. Pour un exemple complet de téléversement de fichiers à l'aide d'opérations d'API, consultez Téléverser des fichiers multimédias à l'aide de l'API ApsaraVideo VOD.

    • Cette opération prend en charge l'obtention de l'URL de téléversement et des informations d'identification pour les fichiers vidéo et audio. Pour plus d'informations, consultez URL et informations d'identification de téléversement.

    • Si les informations d'identification de téléversement expirent (la période de validité par défaut est de 3 000 secondes), appelez l'opération RefreshUploadVideo pour obtenir de nouvelles informations d'identification de téléversement.

    • Une fois le téléversement terminé, vous pouvez configurer des rappels pour recevoir des notifications d'événement de téléversement ou appeler l'opération GetMezzanineInfo pour vérifier l'état du fichier et déterminer si le téléversement a réussi.

    • Le paramètre VideoId renvoyé par cette opération peut être utilisé pour la gestion du cycle de vie des ressources multimédias ou le traitement des médias.

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

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    CoverURL

    string

    Non

    L'URL de la miniature vidéo personnalisée.

    https://example.aliyundoc.com/image/D22F553TEST****.jpeg
    Description

    string

    Non

    La description du fichier audio ou vidéo affichée dans ApsaraVideo VOD une fois le téléversement terminé.

    • La description peut comporter jusqu'à 1 024 caractères.

    • La valeur est encodée en UTF-8.

    UploadTest
    FileName

    string

    Oui

    L'adresse du fichier source audio ou vidéo à téléverser.

    • L'extension du nom de fichier est requise et n'est pas sensible à la casse.

    • Pour les extensions de nom de fichier prises en charge, consultez Présentation du téléversement.

    D:\video_01.mp4
    FileSize

    integer

    Non

    La taille du fichier source audio ou vidéo à téléverser. Unité : octets.

    123
    Title

    string

    Oui

    Le titre du fichier audio ou vidéo affiché dans ApsaraVideo VOD une fois le téléversement terminé.

    • Le titre peut comporter jusqu'à 128 caractères.

    • La valeur est encodée en UTF-8.

    UploadTest
    CateId

    integer

    Non

    L'identifiant de la catégorie. Vous pouvez obtenir l'identifiant de la catégorie en utilisant l'une des méthodes suivantes :

    • Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration de la gestion des médias > Gestion des catégories pour afficher l'identifiant de la catégorie.

    • Lorsque vous créez une catégorie en appelant l'opération AddCategory, l'identifiant de la catégorie est la valeur du paramètre CateId dans la réponse.

    • Lorsque vous interrogez des catégories en appelant l'opération GetCategories, l'identifiant de la catégorie est la valeur du paramètre CateId dans la réponse.

    100036****
    Tags

    string

    Non

    Les balises du fichier audio ou vidéo.

    • Vous pouvez spécifier jusqu'à 16 balises.

    • Pour spécifier plusieurs balises, séparez-les par des virgules (,).

    • Chaque balise peut comporter jusqu'à 32 caractères.

    • La valeur est encodée en UTF-8.

    tag1,tag2
    UserData

    string

    Non

    Les paramètres personnalisés dans une chaîne JSON. Les paramètres prennent en charge les rappels de messages, l'accélération de téléversement et d'autres configurations. Pour plus d'informations, consultez UserData.

    Remarque

    • Pour utiliser le rappel de message dans ce paramètre, vous devez configurer une URL de rappel HTTP et sélectionner les types d'événements de rappel correspondants dans la console. Sinon, les paramètres de rappel ne prennent pas effet. Si aucune URL de rappel n'est spécifiée pour les tâches ultérieures, les rappels sont envoyés à cette adresse par défaut. Pour configurer les rappels HTTP dans la console, consultez Paramètres de rappel.

    • Pour utiliser la fonctionnalité d'accélération de téléversement, vous devez soumettre un formulaire Yida pour demander son activation. Pour plus d'informations, consultez Instructions de téléversement.

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
    TemplateGroupId

    string

    Non

    L'identifiant du groupe de modèles de transcodage. Vous pouvez obtenir l'identifiant en utilisant l'une des méthodes suivantes :

    • Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration du traitement des médias > Groupes de modèles de transcodage pour afficher l'identifiant du groupe de modèles de transcodage.

    • Lorsque vous créez un groupe de modèles de transcodage en appelant l'opération Créer un groupe de modèles de transcodage, l'identifiant du groupe de modèles de transcodage est la valeur du paramètre TranscodeTemplateGroupId dans la réponse.

    • Lorsque vous interrogez des groupes de modèles de transcodage en appelant l'opération Interroger les configurations de transcodage, l'identifiant du groupe de modèles de transcodage est la valeur du paramètre TranscodeTemplateGroupId dans la réponse.

    Remarque

    • Si WorkflowId et TemplateGroupId sont tous deux spécifiés, WorkflowId est prioritaire.

    • Si ce paramètre n'est pas spécifié, le groupe de modèles de transcodage par défaut est utilisé pour le transcodage. Si un identifiant de groupe de modèles de transcodage est spécifié, le groupe de modèles spécifié est utilisé pour le transcodage.

    • Si ce paramètre est défini sur le groupe de modèles intégré Aucun transcodage, seule la notification d'événement Téléversement vidéo terminé est envoyée après le téléversement du fichier audio ou vidéo. La notification d'événement Transcodage terminé pour une seule définition n'est pas envoyée.

    • Ce paramètre déclenche une tâche asynchrone. Après soumission, la tâche n'est pas immédiatement terminée et est mise en file d'attente pour une exécution asynchrone en arrière-plan.

    • Pour garantir une lecture normale, lorsque le groupe de modèles intégré Aucun transcodage est utilisé, seuls les formats suivants prennent en charge la lecture directe sans transcodage après le téléversement du fichier audio ou vidéo : MP4, FLV, MP3, M3U8 et WEBM. Les autres formats prennent uniquement en charge le stockage (vérifiez l'extension du nom de fichier de FileName). Si vous utilisez ApsaraVideo Player, la version du lecteur doit être 3.1.0 ou ultérieure.

    405477f9e214d19ea2c7c854****
    WorkflowId

    string

    Non

    L'identifiant du flux de travail. Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration du traitement des médias > Gestion des flux de travail pour afficher l'identifiant du flux de travail.

    Remarque

    • Si WorkflowId et TemplateGroupId sont tous deux spécifiés, WorkflowId est prioritaire. Pour plus d'informations, consultez Flux de travail.

    • Ce paramètre déclenche une tâche asynchrone. Après soumission, la tâche n'est pas immédiatement terminée et est mise en file d'attente pour une exécution asynchrone en arrière-plan.

    613efff3887ec34af685714cc461****
    StorageLocation

    string

    Non

    L'adresse de stockage. Vous pouvez obtenir l'adresse de stockage en utilisant la méthode suivante : Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration de la gestion des médias > Gestion du stockage pour afficher l'adresse de stockage.

    Remarque

    Si ce paramètre n'est pas spécifié, le fichier audio ou vidéo est téléversé vers l'adresse de stockage par défaut. Si aucune adresse de stockage par défaut n'existe, le fichier est téléversé vers la première adresse de stockage dans la liste de stockage. Si ce paramètre est spécifié, le fichier audio ou vidéo est téléversé vers l'adresse de stockage spécifiée.

    out-****.oss-cn-shanghai.aliyuncs.com
    AppId

    string

    Non

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

    app-1000000
    ReferenceId

    string

    Non

    L'identifiant personnalisé. Seules les lettres minuscules et majuscules, les chiffres, les tirets et les traits de soulignement sont pris en charge. La longueur est de 6 à 64 caractères. L'identifiant est unique au niveau de l'utilisateur.

    123-123
    EnableFirstFrameCover

    boolean

    Non

    GenerateThumbnail

    boolean

    Non

    É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-04D5-D7393642****
    UploadAddress

    string

    L'URL de téléversement.

    Remarque

    L'URL de téléversement renvoyée par cette opération est une valeur encodée en Base64. Lorsque vous utilisez un SDK ou une API pour téléverser des ressources multimédias, vous devez décoder la valeur en Base64 avant de l'utiliser. Seuls les téléversements utilisant le SDK OSS natif ou l'API OSS nécessitent l'analyse de UploadAddress.

    eyJTZWN1cml0eVRva2VuIjoiQ0FJU3p3TjF****
    VideoId

    string

    L'identifiant audio ou vidéo. Cet identifiant peut être utilisé comme paramètre de requête pour la gestion des ressources multimédias, le traitement des médias et les opérations de modération de contenu.

    93ab850b4f6f54b6e91d24d81d44****
    UploadAuth

    string

    Les informations d'identification de téléversement.

    Remarque

    Les informations d'identification de téléversement renvoyées par cette opération sont une valeur encodée en Base64. Lorsque vous utilisez un SDK ou une API pour téléverser des ressources multimédias, vous devez décoder la valeur en Base64 avant de l'utiliser. Seuls les téléversements utilisant le SDK OSS natif ou l'API OSS nécessitent l'analyse de UploadAuth.

    eyJFbmRwb2ludCI6Imm****

    Exemples

    JSON format

    {
  "RequestId": "25818875-5F78-4AF6-04D5-D7393642****",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "VideoId": "93ab850b4f6f54b6e91d24d81d44****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.