Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Téléchargement de médias

Dernière mise à jour :Aug 25, 2026

Le téléchargement de médias permet d'envoyer vos ressources multimédias vers ApsaraVideo VOD. Il constitue un prérequis pour les autres services ApsaraVideo VOD, tels que la gestion des actifs multimédias, le traitement des médias ainsi que la diffusion et la lecture. Cette rubrique décrit les éléments à vérifier avant le téléchargement, les méthodes de téléchargement disponibles, les notifications d'événements de téléchargement et les actions à entreprendre après le téléchargement.

Avant le téléchargement

Formats de médias pris en charge

ApsaraVideo VOD prend en charge le téléchargement de fichiers multimédias tels que des vidéos, des fichiers audio, des images et des actifs multimédias auxiliaires (filigranes, sous-titres et fichiers de matériel). Les fichiers peuvent être des fichiers locaux ou des fichiers réseau (les fichiers réseau utilisent le téléchargement par extraction d'URL). Le tableau suivant répertorie les formats pris en charge pour chaque type de média.

Remarque

Incluez l'extension du nom de fichier lors du téléchargement. Les extensions ne sont pas sensibles à la casse. Par exemple, MP4 et mp4 sont équivalents.

Type de médiaFormats de fichiers pris en charge
Vidéo
  • Formats MPEG : MP4, TS, 3GP, MPG, MPEG, MPE, DAT, VOB, ASF, etc.

  • Format AVI : AVI.

  • Formats Windows Media Video : WMV, ASF.

  • Formats Flash Video : FLV, F4V.

  • Formats Real Video : RM, RMVB.

  • Format QuickTime : MOV.

  • Format Matroska : MKV.

  • Format HLS : M3U8.

Remarque

Pour télécharger un fichier M3U8 via la console ApsaraVideo VOD, vous devez utiliser le téléchargement par extraction d'URL. Pour télécharger un fichier M3U8 local, utilisez l'API ou le SDK ApsaraVideo VOD. Pour plus de détails, consultez Télécharger des fichiers multimédias à l'aide de l'API ApsaraVideo VOD

  • Autres formats : DV, GIF, M2T, M4V, MJ2, MJPEG, MTS, OGG, QT, SWF, WEBM.

AudioMP3, WMA, WAV, AAC, RA, M4A, FLAC, APE, AC3, AMR, CAF, ACM.
ImagePNG, JPG, JPEG, GIF, HEIC.
Actif multimédia auxiliaire
  • Fichier de filigrane : PNG, GIF, APNG, MOV. - Fichier de sous-titres : SRT, ASS, STL, TTML, VTT. - Fichier de matériel : JPG, GIF, PNG, MP4, MAT, ZIP.

Le téléchargement de médias ApsaraVideo VOD prend uniquement en charge les types de médias répertoriés ci-dessus. Pour télécharger d'autres types de fichiers, suivez les étapes décrites dans Télécharger des fichiers vers OSS.

Régions de stockage

ApsaraVideo VOD stocke les ressources multimédias sur la base du service Object Storage Service (OSS) d'Alibaba Cloud. Chaque nœud de stockage correspond à une région de stockage, et ApsaraVideo VOD attribue une adresse de stockage à chaque région de stockage.

Remarque

Lorsque vous téléchargez depuis la console ApsaraVideo VOD ou le client PC, l'adresse de stockage est basée sur la région dans laquelle vous vous connectez ou que vous sélectionnez. Lors d'un téléchargement avec un SDK ou une API, vous pouvez spécifier l'adresse de stockage à l'aide d'un paramètre, tel que le paramètre StorageLocation de l'opération UploadMediaByURL.

ApsaraVideo VOD prend en charge les régions de stockage et les ID de région suivants :

Région de stockage ID de région
Chine (Shanghai) cn-shanghai
Chine (Pékin) cn-beijing
Chine (Shenzhen) cn-shenzhen
Chine (Hong Kong) cn-hongkong
Japon (Tokyo) ap-northeast-1
Singapour ap-southeast-1
Indonésie (Jakarta) ap-southeast-5
Allemagne (Francfort) eu-central-1
États-Unis (Silicon Valley) us-west-1
Remarque

Par défaut, ApsaraVideo VOD ne partage pas les données entre les régions au sein d'un même compte. Avant le téléchargement, assurez-vous que votre région de téléchargement correspond à votre région commerciale réelle. Dans le cas contraire, vous risquez de ne pas retrouver vos fichiers.

À propos des adresses de stockage

Paramètres d'adresse de stockage disponibles Description
Activer l'adresse de stockage système ApsaraVideo VOD Après l'activation d'ApsaraVideo VOD, chaque région de service reçoit par défaut un compartiment de stockage indépendant (un compartiment système ApsaraVideo VOD). Activez ce compartiment pour télécharger et gérer les ressources multimédias sans configuration supplémentaire. Pour plus de détails, consultez Gérer les compartiments de stockage.
Ajouter une adresse de stockage Ajoutez votre propre compartiment OSS à ApsaraVideo VOD afin de pouvoir transcoder, capturer des instantanés et lire les fichiers multimédias stockés dans le compartiment OSS. Pour plus de détails, consultez Gérer les compartiments de stockage.
Modifier l'adresse de stockage par défaut Après avoir activé les adresses de stockage pour plusieurs régions de stockage ou ajouté plusieurs adresses de stockage, vous pouvez modifier l'adresse de stockage par défaut. Lors du téléchargement de fichiers, vous pouvez spécifier une adresse de stockage ou la laisser non spécifiée. Si vous n'en spécifiez aucune, ApsaraVideo VOD utilise l'adresse de stockage par défaut. Pour plus de détails, consultez Gérer les compartiments de stockage.

Facturation du stockage

Le stockage ApsaraVideo VOD propose deux méthodes de facturation : paiement à l'utilisation (postpayé) et plans de ressources (prépayé).

Méthodes de téléchargement

ApsaraVideo VOD propose des méthodes de téléchargement manuel et programmatique (automatisé) adaptées à différents scénarios utilisateurs. Suivez les recommandations ci-dessous pour choisir une méthode et consultez le tableau récapitulatif pour plus de détails.

  • Télécharger rapidement quelques petits fichiers : Utilisez la console.

  • Télécharger de gros fichiers ou effectuer des téléchargements longs : Utilisez le client PC.

  • Téléchargements par lots ou intégration automatisée : Utilisez le SDK de téléchargement côté serveur.

  • Télécharger des fichiers réseau : Utilisez le téléchargement par extraction d'URL.

Méthode de téléchargementScénariosDescription
Téléchargement manuelTélécharger des fichiers vers la console ApsaraVideo VODScénarios nécessitant un moyen rapide et pratique de télécharger des ressources multimédias vers ApsaraVideo VOD.
Remarque

En raison des politiques de sécurité de la console, les téléchargements longs peuvent échouer pour les gros fichiers lorsque la session de connexion expire. Pour éviter ce problème, téléchargez les gros fichiers avec le client PC.

  • Après l'activation d'ApsaraVideo VOD, connectez-vous à la console dans un navigateur pour télécharger.

  • Pour les médias audio et vidéo, la console prend en charge le téléchargement de fichiers locaux et le téléchargement par extraction d'URL.

Télécharger des fichiers à l'aide du client WindowsGros fichiers, téléchargements longs et scénarios opérationnels simples.
  • Téléchargez et installez le client ApsaraVideo VOD. Seul le client Windows est pris en charge.

  • Prend uniquement en charge le téléchargement de fichiers locaux.

Intégration programmatiqueTélécharger à l'aide du SDK de téléchargement
  • Scénarios de téléchargements automatisés et de migration vidéo à grande échelle.

  • Téléchargements de fichiers multimédias réseau.

Remarque

Nous recommandons l'utilisation du SDK de téléchargement. Si le SDK de téléchargement ne prend pas en charge votre langage, vous pouvez utiliser un SDK natif OSS pour télécharger.

  • Le SDK de téléchargement côté serveur encapsule la logique ApsaraVideo VOD pour l'obtention des informations d'identification de téléchargement et de l'URL de téléchargement, ainsi que les capacités de téléchargement OSS. Une configuration simple suffit pour télécharger.

  • Les langages pris en charge incluent Java, Python, PHP et C/C++.

Télécharger des fichiers multimédias à l'aide des SDK OSS
  • Scénarios de téléchargements automatisés et de migration vidéo à grande échelle.

  • Téléchargements de fichiers multimédias réseau.

  • Avec la méthode du SDK natif OSS, vous devez implémenter toute la logique de téléchargement vous-même : obtenir l'URL de téléchargement et les informations d'identification auprès d'ApsaraVideo VOD, décoder en Base64 les informations d'identification et l'URL de téléchargement, puis appeler les capacités OSS pour terminer le téléchargement.

  • Les langages pris en charge incluent Java, Python, PHP, .NET, Go, Node.js et C/C++.

Remarque

Pour Java, Python, PHP et C/C++, nous recommandons le SDK de téléchargement ApsaraVideo VOD.

Téléchargement par lots à partir d'URLScénarios où les fichiers ne sont pas stockés sur un serveur local ou un terminal et doivent être téléchargés à partir d'une URL accessible depuis le réseau public.
  • Prend en charge le téléchargement uniquement vers les régions Chine (Shanghai) et Singapour.

  • Ne s'applique pas aux téléchargements de fichiers locaux.

Comparaison des fonctionnalités par méthode de téléchargement

Le tableau suivant compare les fonctionnalités prises en charge par chaque méthode de téléchargement pendant le processus. Les marques ① et ② correspondent aux explications des fonctionnalités qui suivent le tableau.

Groupe Fonctionnalité Console Client PC SDK côté serveur-Java SDK côté serveur-Python SDK côté serveur-PHP SDK côté serveur-C/C++ SDK OSS
Gestion des actifs multimédias Définir le titre du média Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Spécifier la catégorie du média Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Définir des tags de média Non pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Définir la vignette vidéo Non pris en charge Non pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Transcodage audio et vidéo① Groupe de modèles de transcodage Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Flux de travail multimédia Pris en charge Non pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Aucun transcodage Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Contrôle du téléchargement② Obtenir la progression du téléchargement Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge
Téléchargement avec reprise Non pris en charge Non pris en charge Pris en charge par le SDK de téléchargement Java uniquement Pris en charge Non pris en charge Non pris en charge Non pris en charge
Téléchargement multipartie Activé par défaut Activé par défaut Activé par défaut Activé par défaut Activé par défaut Activé par défaut Activé par défaut

Les notes suivantes expliquent les groupes de fonctionnalités marqués par ① et ② dans le tableau précédent.

Transcodage audio et vidéo①

Définissez le transcodage lors du téléchargement d'un fichier audio ou vidéo (en spécifiant un groupe de modèles de transcodage ou un flux de travail multimédia) ; le transcodage démarre automatiquement une fois le téléchargement terminé. Vous pouvez également choisir de ne pas effectuer de transcodage. Toutefois, notez que Seules les vidéos aux formats suivants peuvent être lues sans transcodage : MP4, FLV, M3U8, MP3 et WEBM.

  • Transcoder avec un groupe de modèles de transcodage : L'utilisation d'un groupe de modèles de transcodage est la méthode de traitement par défaut d'ApsaraVideo VOD. Lors du téléchargement, sélectionnez la méthode de traitement par groupe de modèles de transcodage. ApsaraVideo VOD démarre automatiquement le transcodage une fois le téléchargement terminé.

  • Transcoder avec un flux de travail multimédia : Après avoir créé un flux de travail multimédia contenant des tâches de transcodage, sélectionnez la méthode de traitement par flux de travail multimédia lors du téléchargement. Une fois le téléchargement terminé, ApsaraVideo VOD exécute automatiquement le flux de travail multimédia spécifié pour effectuer le transcodage.

  • Aucun transcodage : Si vous n'avez pas besoin de transcodage lors du téléchargement, sélectionnez le modèle No Transcoding dans le groupe de modèles de transcodage.

Contrôle du téléchargement②

  • Téléchargement multipartie : Le fichier à télécharger est divisé en plusieurs parties qui sont téléchargées séparément, puis combinées en un seul objet une fois le téléchargement terminé. ApsaraVideo VOD télécharge les fichiers en utilisant le téléchargement multipartie par défaut.

Remarque

Lorsque vous utilisez le téléchargement multipartie, si le téléchargement échoue, des fichiers fragments peuvent être générés. Ceux-ci sont automatiquement supprimés après environ sept jours. Vous pouvez également appeler l'opération DeleteMultipartUpload pour supprimer manuellement les fichiers fragments.

  • Obtenir la progression ou le statut du téléchargement.

  • Téléchargement avec reprise : Si une erreur réseau entraîne l'échec du téléchargement, ApsaraVideo VOD peut reprendre le téléchargement à partir de la dernière partie téléchargée avec succès, permettant ainsi un téléchargement avec reprise.

Remarque

Le téléchargement avec reprise est géré en interne par le SDK de téléchargement (client). Vous n'avez pas besoin de gérer les points de reprise ou la récupération des fragments, car un nouveau téléchargement après un échec causé par une exception reprend à partir du point de reprise.

Notifications d'événements de téléchargement

Une fois le téléchargement d'un fichier multimédia terminé, vous pouvez obtenir la progression du traitement et le statut en temps opportun via une adresse de rappel préconfigurée. ApsaraVideo VOD prend en charge deux méthodes de rappel pour les notifications d'événements : le rappel HTTP (compatible HTTPS) et le rappel Message Service (MNS). Pour en savoir plus sur la configuration des rappels, consultez Notification d'événement. Pour effectuer la configuration du rappel, consultez Configurer les rappels. Toutes les méthodes de téléchargement prennent en charge les notifications d'événements de téléchargement. Les événements liés au téléchargement sont répertoriés dans le tableau suivant.

Remarque

Pour plus de détails sur chaque événement, consultez Notifications d'événements.

Nom de l'événementType d'événementDescription
Video Upload CompleteFileUploadCompleteGénéré après que le serveur ApsaraVideo VOD a fini de recevoir un fichier audio ou vidéo téléchargé.
Remarque

Pour les fichiers audio et vidéo (ou audio) non transcodés, vous pouvez obtenir l'URL de lecture uniquement après avoir reçu la notification d'événement Video Upload Complete. Si vous avez désactivé le transcodage lors du téléchargement, après avoir reçu la notification d'événement Video Upload Complete, vous pouvez appeler l'opération Soumettre des tâches de transcodage multimédia pour effectuer le transcodage.

Image Upload CompleteImageUploadCompleteGénéré après que le serveur ApsaraVideo VOD a fini de recevoir un fichier image téléchargé.
Auxiliary Media Upload CompleteAttachedMediaUploadCompleteGénéré après que le serveur ApsaraVideo VOD a fini de recevoir un fichier d'actif multimédia auxiliaire téléchargé.
Video Upload from URL CompleteUploadByURLCompleteAprès avoir appelé la tâche Télécharger des fichiers multimédias par URL, l'événement UploadByURLComplete est généré lorsque le cloud termine l'extraction et le téléchargement de la vidéo.
Stream Transcode CompleteStreamTranscodeCompleteGénéré lorsqu'un flux d'une définition et d'un format spécifiques pour une vidéo (par exemple, un fichier MP4 en définition standard) termine son transcodage.
Remarque

Pour les fichiers audio et vidéo transcodés, vous pouvez obtenir l'URL de lecture uniquement après avoir reçu la notification d'événement Stream Transcode Complete. La lecture avant la réception du rappel peut entraîner un échec de la lecture.

Video Transcode CompleteTranscodeCompleteGénéré lorsque tous les flux d'une vidéo ont terminé leur transcodage.
Remarque

Pour garantir que toutes les définitions sont disponibles avant la lecture, attendez de recevoir la notification d'événement Video Transcode Complete avant de poursuivre. La lecture avant la réception du rappel peut entraîner un échec de la lecture.

Actions à entreprendre après le téléchargement

Remarque

Une fois les ressources multimédias téléchargées vers ApsaraVideo VOD, elles entrent dans différents états de média en fonction de la situation et de l'étape du traitement métier. Les ressources audio et vidéo dans différents états de média prennent en charge différentes opérations. Par exemple, les fichiers audio et vidéo dans les états Uploading, Upload Failed ou Blocked ne peuvent être que supprimés et ne prennent en charge aucune autre opération (vous ne pouvez pas démarrer le transcodage, capturer des instantanés vidéo ou examiner les actifs multimédias). Les fichiers audio et vidéo dans l'état Normal prennent en charge toutes les opérations, y compris le transcodage, les instantanés vidéo, l'examen des actifs multimédias et la lecture. Pour plus de détails sur les états des médias, consultez Statut : statut vidéo et Statut : statut image.

Les services ApsaraVideo VOD disponibles après le téléchargement et les remarques concernant la diffusion et la lecture ultérieures sont les suivants :

Service ApsaraVideo VODDescriptionRéférences
Gestion des actifs multimédias (après le téléchargement)Une fois le téléchargement terminé, utilisez ApsaraVideo VOD pour gérer les fichiers multimédias, tels que les fichiers source vidéo, les fichiers de flux transcodés et les fichiers image.Gestion des actifs multimédias
Traitement des médiasApsaraVideo VOD prend en charge les opérations post-téléchargement telles que le transcodage audio et vidéo, l'examen automatisé, l'édition en ligne (édition vidéo dans le cloud) et le traitement IA.
Remarque

Les fichiers audio et vidéo téléchargés vers le stockage ApsaraVideo VOD voient leurs métadonnées (telles que la résolution vidéo, la durée et le débit binaire) extraites par défaut, et des vignettes et sprites sont capturés pour les vidéos par défaut. Ce prétraitement est entièrement gratuit.

Traitement des médias
Lecture audio et vidéoAprès avoir terminé le téléchargement d'un fichier audio ou vidéo, le fichier n'est pas nécessairement prêt. Le serveur ApsaraVideo VOD doit confirmer qu'il a fini de recevoir le fichier. Utilisez les notifications d'événements pour déterminer quand le fichier audio ou vidéo téléchargé est prêt pour la lecture.
  • Pour les fichiers audio et vidéo (ou audio) non transcodés, vous pouvez obtenir l'URL de lecture après avoir reçu la notification d'événement Video Upload Complete.

  • Pour les fichiers audio et vidéo transcodés, vous pouvez obtenir l'URL de lecture après avoir reçu la notification d'événement Stream Transcode Complete. Pour garantir que toutes les définitions sont disponibles, attendez de recevoir la notification d'événement Video Transcode Complete avant de poursuivre.

Sécurité du téléchargement

Dans les scénarios de téléchargement programmatique, les informations d'identification de téléchargement et STS résolvent les problèmes d'autorisation et de sécurité lors du téléchargement, empêchant le téléchargement et la lecture malveillants de fichiers multimédias.

Restreindre les téléchargements de fichiers en lecture publique

Depuis le 31 janvier 2024, ApsaraVideo VOD ne prend plus en charge la modification des autorisations de fichier via l'en-tête OSS x-oss-object-acl. Cela permet d'éviter efficacement les problèmes tels que les fuites de ressources multimédias ou les pics de coûts dus à un accès malveillant causés par le téléchargement direct de fichiers en lecture publique. Pour restreindre le téléchargement de fichiers en lecture publique vers vos propres compartiments OSS dans ApsaraVideo VOD, vous pouvez utiliser les méthodes de gestion des autorisations suivantes :

Pour accorder l'autorisation au rôle AliyunVODDefaultRole

  1. Connectez-vous à la console Resource Access Management (RAM). Pour la procédure, consultez Gérer les autorisations des utilisateurs RAM.

  2. Dans le volet de navigation de gauche, cliquez sur Roles, puis recherchez et cliquez sur AliyunVODDefaultRole.

  3. Dans l'onglet Permissions, cliquez sur Grant Permission.

  4. Dans le panneau qui s'affiche, sélectionnez l'onglet Custom Policy, sélectionnez la politique cible, puis terminez l'autorisation.

Accélération du téléchargement

ApsaraVideo VOD propose l'accélération du téléchargement pour améliorer le transfert de fichiers sur de longues distances et de fichiers volumineux de niveau GB ou TB. L'accélération du téléchargement s'applique aux téléchargements interrégionaux (tels que les transferts transocéaniques), par exemple, le téléchargement de vidéos depuis la Chine continentale vers une adresse de stockage dans la région de stockage de Singapour.

Comment activer

Pour activer l'accélération du téléchargement, soumettre un ticket. Indiquez votre UID de compte Alibaba Cloud et l'adresse de stockage que vous souhaitez accélérer.

Facturation

L'accélération du téléchargement est une fonctionnalité à valeur ajoutée d'ApsaraVideo VOD et est facturée à l'utilisation. Pour plus de détails sur la facturation, consultez Facturation de l'accélération de transfert.

Remarque

Aucun frais ne vous est facturé si vous activez la fonctionnalité mais ne l'utilisez pas.

Limitations

Seul Télécharger des fichiers vers la console ApsaraVideo VOD ne prend pas en charge l'accélération. Toutes les autres méthodes de téléchargement la prennent en charge.

Facturation

Le téléchargement d'actifs multimédias vers ApsaraVideo VOD n'entraîne pas de frais supplémentaires. Les frais connexes proviennent des ressources de service Alibaba Cloud ApsaraVideo VOD que vous utilisez.

Élément de facturation Description
Frais de stockage Frais de stockage des fichiers multimédias après le téléchargement, facturés en fonction du volume de stockage et de la durée.
Frais de trafic Le trafic de téléchargement est gratuit (le trafic entrant du client vers ApsaraVideo VOD n'est pas facturé). Le trafic de lecture descendant est facturé séparément.
Frais de transcodage Si le transcodage est déclenché après le téléchargement, facturé en fonction de la durée du fichier de sortie et de la spécification de transcodage. Aucun frais si aucun transcodage n'est effectué.
Frais d'accélération du téléchargement Lorsque vous activez et utilisez l'accélération du téléchargement, facturé en supplément en fonction du trafic accéléré.

Pour plus de détails sur la facturation, consultez Facturation des services de base et Plans de ressources.