Todos os produtos
Search
Central de documentação

Intelligent Media Management:Extract video captions

Última atualização: Sep 22, 2026

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.

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

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

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

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

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

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

    Importante

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