Use a API de transcodificação de mídia do Intelligent Media Management (IMM) para extrair legendas textuais e gráficas de arquivos de vídeo.
Visão geral
A extração de legendas de vídeo separa os dados de legenda dos arquivos de vídeo, permitindo acessar e edite o conteúdo textual de forma independente. Esse recurso viabiliza legendas multilíngues, acessibilidade e criação de legendas.

Casos de uso
Suporte multilíngue: crie legendas em vários idiomas para tornar o conteúdo de vídeo acessível a públicos diversificados.
Tradução e localização: extraia texto de vídeos para traduzir e gerar versões localizadas que respeitem o idioma e as normas culturais de cada região.
Dublagem e reconhecimento de fala: forneça roteiros precisos para trabalhos de locução e dados de treinamento para sistemas de reconhecimento de fala.
Edição e produção de vídeo: extraia e organize legendas para facilitar a edição, a revisão e o refinamento do conteúdo.
Limitações
Apenas legendas textuais e legendas gráficas são compatíveis. Legendas incorporadas diretamente no fluxo de vídeo como parte da imagem não são compatíveis. Para outros requisitos, contact us.
Procedimento
Pré-requisitos
Crie um AccessKey. Para mais informações, consulte Create an AccessKey.
Ative o Object Storage Service (OSS) e crie um bucket. Para mais informações, consulte Create a bucket.
Ative o Intelligent Media Management (IMM). Para mais informações, consulte Activate IMM.
-
Crie um projeto no console do IMM. Para mais informações, consulte Create a project.
NotaTambém é possível chamar uma operação de API para criar um projeto. Para mais informações, consulte Create a project.
Chame a operação ListProjects para listar todos os projetos criados em uma região especificada.
Etapa 1: Faça upload de um arquivo
Faça upload do seu arquivo de mídia para um bucket do OSS na mesma região do seu projeto IMM.
Na página de upload, mantenha File ACL definido como Inherit Bucket (padrão), clique em Scan File para selecione o arquivo e, em seguida, clique em Upload File.
Etapa 2: Extraia as legendas
Chame a operação CreateMediaConvertTask para crie uma tarefa de extração de legendas de vídeo.
O processo de extração inclui as seguintes etapas:
Detecção de formato: identifique os formatos de legenda no arquivo de vídeo, como SRT, ASS, WebVTT e fluxos de legenda incorporados.
Extração de dados: extraia o texto das legendas e os timestamps do arquivo de vídeo, incluindo nomes de locutores, marcadores de tempo e formatação.
Processamento de texto: edite as legendas extraídas conforme necessário — remova informações redundantes, reformate, traduza ou corrija erros.
Saída: salve as legendas processadas em um formato especificado (como .srt ou .ass) para uso posterior ou upload em uma plataforma de vídeo.
Exemplos de parâmetros
Os exemplos a seguir utilizam o projeto IMM test-project e o arquivo oss://test-bucket/video-demo/test.mp4 para extrair legendas de vídeo.
A extração de legendas faz parte das funcionalidades de Media transcoding.
Use o OpenAPI Explorer para chamar a API de transcodificação de mídia e visualize exemplos de código SDK.
Não defina Target.URI nem Target.Container ao extrair legendas.
Inclua a variável {streamindex} no URI de saída das legendas, por exemplo "oss://test-bucket/objectPrefix-{streamindex}.{autoext}". Sem essa variável, as legendas podem ser sobrescritas.
Extrair todas as legendas de um vídeo como legendas WebVTT
Formato de legenda: webvtt
Caminho do arquivo de legenda de saída:
oss://test-bucket/video-demo/subtitle-%d.vttNotificação de conclusão: tópico MNS "test-mns-topic"
Teste este exemplo no OpenAPI Explorer com parâmetros pré-preenchidos. Modifique-os conforme necessário.
Parâmetros da requisição
{
"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}"
}
}
}
]
}
Extrair todas as legendas de um vídeo como legendas SRT
Formato de legenda: srt
Caminho do arquivo de legenda de saída:
oss://test-bucket/video-demo/subtitle-%d.srtNotificação de conclusão: tópico MNS "test-mns-topic"
Teste este exemplo no OpenAPI Explorer com parâmetros pré-preenchidos. Modifique-os conforme necessário.
Parâmetros da requisição
{
"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}"
}
}
}
]
}
Faturamento
A extração de legendas de vídeo gera cobranças tanto do OSS quanto do IMM. Detalhes de preços: IMM billing items.
-
Faturamento do OSS: OSS Pricing
API
Item de faturamento
Descrição
GetObject
Requisições GET
Cobrança com base no número de requisições bem-sucedidas.
Capacidade de recuperação de dados Infrequent Access
Cobrança pelo volume de dados Infrequent Access recuperados.
Cota de recuperação de dados para acesso em tempo real de objetos Archive
Cobrança pelo volume de dados Archive recuperados por meio de acesso em tempo real.
Aceleração de transferência
Cobrança por volume de dados ao acessar o bucket por meio de um endpoint de aceleração.
PutObject
Requisições PUT
Cobrança com base no número de requisições bem-sucedidas.
Taxa de armazenamento
Cobrança com base na classe de armazenamento, no tamanho e na duração do armazenamento do objeto.
HeadObject
Requisições GET
Cobrança com base no número de requisições bem-sucedidas.
-
Faturamento do IMM: IMM billing items.
ImportanteA partir das 11:00 UTC+8 de 28 de julho de 2025, a extração de legendas de vídeo do IMM passa de gratuita para paga. Anúncio de ajuste de faturamento do IMM.
API
Item de faturamento
Descrição
CreateMediaConvertTask
ExtractSubtitleText
Cobrança com base no número de fluxos de legendas textuais extraídos com sucesso.
CreateMediaConvertTask
ExtractSubtitleImage
Cobrança com base na duração total dos fluxos de legendas gráficas extraídos com sucesso.