Use a API de transcodificação de mídia do Intelligent Media Management (IMM) para extrair legendas baseadas em texto 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 e permite acessar e editar o conteúdo textual de forma independente. Esse recurso oferece suporte a 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 diversos.
Tradução e localização: Extraia texto de vídeos para tradução em versões localizadas, adequadas às normas linguísticas e culturais regionais.
Dublagem e reconhecimento de fala: Forneça roteiros precisos para trabalhos de dublagem 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, revisão e refinamento.
Limites
O sistema aceita apenas legendas baseadas em texto e legendas gráficas. Não há suporte para legendas incorporadas diretamente ao fluxo de vídeo como parte da imagem. Para outros requisitos, entre em contato conosco.
Procedimento
Pré-requisitos
Crie uma AccessKey. Para mais informações, consulte Criar uma AccessKey.
Ative o Object Storage Service (OSS) e crie um bucket. Para mais informações, consulte Criar um bucket.
Ative o Intelligent Media Management (IMM). Para mais informações, consulte Ativar o IMM.
-
Crie um projeto no console do IMM. Para mais informações, consulte Criar um projeto.
NotaTambém é possível chamar uma operação de API para criar um projeto. Para mais informações, consulte Criar um projeto.
Chame a operação ListProjects para listar todos os projetos criados em uma região específica.
Etapa 1: Carregar um arquivo
Carregue seu arquivo de mídia em um bucket do OSS na mesma região do seu projeto do IMM.
Na página de upload, mantenha File ACL definido como Inherit Bucket (padrão), clique em Scan File para selecionar seu arquivo e, em seguida, clique em Upload File.
Etapa 2: Extrair legendas
Chame a operação CreateMediaConvertTask para criar uma tarefa de extração de legendas de vídeo.
O processo de extração inclui as seguintes etapas:
Detecção de formato: Identifica os formatos de legenda no arquivo de vídeo, como SRT, ASS, WebVTT e fluxos de legendas incorporados.
Extração de dados: Extrai o texto da legenda e os carimbos de data/hora do arquivo de vídeo, incluindo nomes de falantes, 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 carregamento em uma plataforma de vídeo.
Exemplos de parâmetros
Os exemplos a seguir usam o projeto do 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 dos recursos de Transcodificação de mídia.
Use o OpenAPI Explorer para chamar a API de transcodificação de mídia e visualizar exemplos de código SDK.
Não defina Target.URI ou Target.Container ao extrair legendas.
Inclua a variável {streamindex} na URI de saída da legenda, por exemplo "oss://test-bucket/objectPrefix-{streamindex}.{autoext}". Sem ela, as legendas podem se sobrescrever.
Extrair todas as legendas de um vídeo como legendas WebVTT
Formato da 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 solicitaçã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 da 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 solicitaçã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: Itens de faturamento do IMM.
-
Faturamento do OSS: Preços do OSS
API
Item de faturamento
Descrição
GetObject
Solicitações GET
Cobrado com base no número de solicitações bem-sucedidas.
Capacidade de recuperação de dados de Acesso Infrequente
Cobrado pelo volume de dados de Acesso Infrequente recuperados.
Cota de recuperação de dados para acesso em tempo real de objetos Archive
Cobrado pelo volume de dados Archive recuperados por meio de acesso em tempo real.
Aceleração de transferência
Cobrado por volume de dados ao acessar o bucket por meio de um endpoint de aceleração.
PutObject
Solicitações PUT
Cobrado com base no número de solicitações bem-sucedidas.
Taxa de armazenamento
Cobrado com base na classe de armazenamento, tamanho e duração do armazenamento do objeto.
HeadObject
Solicitações GET
Cobrado com base no número de solicitações bem-sucedidas.
-
Faturamento do IMM: Itens de faturamento do IMM.
ImportanteA partir das 11:00 UTC+8 de 28 de julho de 2025, a extração de legendas de vídeo do IMM deixará de ser gratuita e passará a ser paga. Anúncio de ajuste de faturamento do IMM.
API
Item de faturamento
Descrição
CreateMediaConvertTask
ExtractSubtitleText
Cobrado com base no número de fluxos de legendas baseadas em texto extraídos com sucesso.
CreateMediaConvertTask
ExtractSubtitleImage
Cobrado com base na duração total dos fluxos de legendas gráficas extraídos com sucesso.