Todos os produtos
Search
Central de documentação

Intelligent Media Management:Extrair legendas de vídeo

Última atualização: Jun 27, 2026

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.

006

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.

    Nota
    • També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:

  1. Detecção de formato: Identifica os formatos de legenda no arquivo de vídeo, como SRT, ASS, WebVTT e fluxos de legendas incorporados.

  2. 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.

  3. Processamento de texto: Edite as legendas extraídas conforme necessário — remova informações redundantes, reformate, traduza ou corrija erros.

  4. 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.

Nota
  • 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.vtt

  • Notificaçã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.srt

  • Notificaçã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.

    Importante

    A 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.