Utilisez l'API de transcodage multimédia d'Intelligent Media Management (IMM) pour extraire les sous-titres textuels et graphiques des fichiers vidéo.
Présentation
L'extraction des sous-titres vidéo sépare les données de sous-titrage des fichiers vidéo, ce qui permet d'accéder au contenu textuel et de le modifier indépendamment. Cette fonctionnalité prend en charge les sous-titres multilingues, l'accessibilité et la création de sous-titres.

Cas d'utilisation
Prise en charge multilingue : Créez des sous-titres dans plusieurs langues afin de rendre le contenu vidéo accessible à un public diversifié.
Traduction et localisation : Extrayez le texte des vidéos pour le traduire et créer des versions localisées adaptées aux normes linguistiques et culturelles régionales.
Doublage et reconnaissance vocale : Fournissez des scripts précis pour le travail de voix off et des données d'entraînement pour les systèmes de reconnaissance vocale.
Montage et production vidéo : Extrayez et organisez les sous-titres pour faciliter le montage, la relecture et l'affinement.
Limites
Seuls les sous-titres textuels et les sous-titres graphiques sont pris en charge. Les sous-titres incrustés directement dans le flux vidéo en tant qu'élément de l'image ne sont pas pris en charge. Pour toute autre demande, contactez-nous.
Procédure
Prérequis
Créez une AccessKey. Pour plus d'informations, consultez la rubrique Créer une AccessKey.
Activez Object Storage Service (OSS) et créez un bucket. Pour plus d'informations, consultez la rubrique Créer un bucket.
Activez Intelligent Media Management (IMM). Pour plus d'informations, consultez la rubrique Activer IMM.
-
Créez un projet dans la console IMM. Pour plus d'informations, consultez la rubrique Créer un projet.
RemarqueVous pouvez également appeler une opération API pour créer un projet. Pour plus d'informations, consultez la rubrique Créer un projet.
Appelez l'opération ListProjects pour répertorier tous les projets créés dans une région spécifiée.
Étape 1 : Télécharger un fichier
Téléchargez votre fichier multimédia dans un bucket OSS situé dans la même région que votre projet IMM.
Sur la page de téléchargement, conservez le paramètre File ACL défini sur Inherit Bucket (valeur par défaut), cliquez sur Scan File pour sélectionner votre fichier, puis cliquez sur Upload File.
Étape 2 : Extraire les sous-titres
Appelez l'opération CreateMediaConvertTask pour créer une tâche d'extraction de sous-titres vidéo.
Le processus d'extraction comprend les étapes suivantes :
Détection du format : Identifiez les formats de sous-titres présents dans le fichier vidéo, tels que SRT, ASS, WebVTT et les flux de sous-titres intégrés.
Extraction des données : Extrayez le texte des sous-titres et les horodatages du fichier vidéo, y compris les noms des locuteurs, les marqueurs temporels et le formatage.
Traitement du texte : Modifiez les sous-titres extraits selon vos besoins : supprimez les informations redondantes, reformatez, traduisez ou corrigez les erreurs.
Sortie : Enregistrez les sous-titres traités dans un format spécifié (par exemple .srt ou .ass) pour une utilisation ultérieure ou téléchargez-les sur une plateforme vidéo.
Exemples de paramètres
Les exemples suivants utilisent le projet IMM test-project et le fichier oss://test-bucket/video-demo/test.mp4 pour extraire les sous-titres vidéo.
L'extraction des sous-titres fait partie des fonctionnalités de transcodage multimédia.
Utilisez OpenAPI Explorer pour appeler l'API de transcodage multimédia et afficher des exemples de code SDK.
Ne définissez pas Target.URI ni Target.Container lors de l'extraction des sous-titres.
Incluez la variable {streamindex} dans l'URI de sortie des sous-titres, par exemple « oss://test-bucket/objectPrefix-{streamindex}.{autoext} ». Sans cette variable, les sous-titres risquent de s'écraser mutuellement.
Extraire tous les sous-titres d'une vidéo au format WebVTT
Format des sous-titres : webvtt
Chemin du fichier de sous-titres de sortie :
oss://test-bucket/video-demo/subtitle-%d.vttNotification de fin : rubrique MNS « test-mns-topic »
Essayez cet exemple dans OpenAPI Explorer avec des paramètres préremplis. Modifiez-les si nécessaire.
Paramètres de requête
{
"ProjectName": "test-project",
"Notification": {
"MNS": {
"TopicName": "test-mns-topic"
}
},
"Sources": [
{
"URI": "oss://test-bucket/video-demo/test.mp4"
}
],
"Targets": [
{
"Subtitle": {
"ExtractSubtitle": {
"Format": "webvtt",
"URI": "oss://test-bucket/video-demo/subtitle-{streamindex}.{autoext}"
}
}
}
]
}
Extraire tous les sous-titres d'une vidéo au format SRT
Format des sous-titres : srt
Chemin du fichier de sous-titres de sortie :
oss://test-bucket/video-demo/subtitle-%d.srtNotification de fin : rubrique MNS « test-mns-topic »
Essayez cet exemple dans OpenAPI Explorer avec des paramètres préremplis. Modifiez-les si nécessaire.
Paramètres de requête
{
"ProjectName": "test-project",
"Notification": {
"MNS": {
"TopicName": "test-mns-topic"
}
},
"Sources": [
{
"URI": "oss://test-bucket/video-demo/test.mp4"
}
],
"Targets": [
{
"Subtitle": {
"ExtractSubtitle": {
"Format": "srt",
"URI": "oss://test-bucket/video-demo/subtitle-{streamindex}.{autoext}"
}
}
}
]
}
Facturation
L'extraction des sous-titres vidéo entraîne des frais OSS et IMM. Détails tarifaires : Éléments de facturation IMM.
-
Facturation OSS : Tarification OSS
API
Élément de facturation
Description
GetObject
Requêtes GET
Facturé en fonction du nombre de requêtes abouties.
Capacité de récupération des données Infrequent Access
Facturé en fonction du volume de données Infrequent Access récupérées.
Quota de récupération des données pour l'accès en temps réel aux objets Archive
Facturé en fonction du volume de données Archive récupérées via un accès en temps réel.
Accélération du transfert
Facturé en fonction du volume de données lors de l'accès au bucket via un endpoint d'accélération.
PutObject
Requêtes PUT
Facturé en fonction du nombre de requêtes abouties.
Frais de stockage
Facturé en fonction de la classe de stockage, de la taille et de la durée de stockage des objets.
HeadObject
Requêtes GET
Facturé en fonction du nombre de requêtes abouties.
-
Facturation IMM : Éléments de facturation IMM.
ImportantÀ partir du 28 juillet 2025 à 11 h 00 (UTC+8), l'extraction des sous-titres vidéo par IMM passe du statut gratuit au statut payant. Annonce relative à l'ajustement de la facturation IMM.
API
Élément de facturation
Description
CreateMediaConvertTask
ExtractSubtitleText
Facturé en fonction du nombre de flux de sous-titres textuels extraits avec succès.
CreateMediaConvertTask
ExtractSubtitleImage
Facturé en fonction de la durée totale des flux de sous-titres graphiques extraits avec succès.