Todos os produtos
Search
Central de documentação

Intelligent Media Management:Converter vídeo em imagem animada

Última atualização: Jun 27, 2026

Este tópico descreve como usar a API de transcodificação de mídia do Intelligent Media Management (IMM) para converter vídeos em imagens animadas.

Visão geral

A conversão de vídeo para imagem animada transforma um arquivo de vídeo em um formato de imagem animada, como GIF ou WebP. Isso facilita o compartilhamento e a incorporação em sites e redes sociais.

zhuandongtu

Cenários

  • Compartilhamento em redes sociais: Imagens animadas permitem compartilhar clipes curtos de vídeo em plataformas sociais para expressar emoções, momentos engraçados ou informações importantes.

  • Memes online: Converta vídeos em imagens animadas para criar memes divertidos ou humorísticos que enriquecem as conversas na internet.

  • Tutoriais e demonstrações: Use imagens animadas em aulas ou demonstrações para exibir operações de software ou instruções passo a passo. Isso ajuda os espectadores a compreender rapidamente conceitos e procedimentos complexos.

  • Transmissões ao vivo e replays de eventos: Durante jogos, eventos ou transmissões ao vivo, utilize imagens animadas para recortar e compartilhar rapidamente momentos emocionantes com os espectadores e aumentar o engajamento.

Formatos de áudio e vídeo compatíveis

Categoria

Formato

Áudio

Todos os formatos principais, como AAC, MP3, WAV, FLAC, WMA, AC3 e OPUS.

Vídeo

Todos os formatos principais, como MP4, MPEG-TS, MKV, MOV, AVI, FLV, M3U8, WebM, WMV, RM e VOB.

Como usar

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 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: Fazer upload de um arquivo

Use o console do OSS para fazer upload do arquivo de mídia em um bucket na mesma região do projeto IMM.

Na página de upload, mantenha File ACL definido com o valor padrão Inherit Bucket, clique em Scan Files e selecione o arquivo de mídia para upload.

Etapa 2: Usar o IMM para converter vídeo em imagem animada

Chame a API Create Media Transcoding Job para criar um trabalho de conversão de vídeo para imagem animada.

Faturamento

A conversão de vídeo para imagem animada gera cobranças tanto do OSS quanto do IMM.

  • Faturamento do OSS: Para preços detalhados, consulte Preços do OSS.

    API

    Item faturável

    Descrição

    GetObject

    Requisições GET

    Cobrança baseada no número de requisições bem-sucedidas.

    Capacidade de recuperação de dados de Acesso Infrequente

    Se os dados recuperados estiverem armazenados na classe de armazenamento de Acesso Infrequente, haverá cobrança pelo volume de dados recuperados.

    Capacidade de recuperação de dados de objetos Archive com acesso em tempo real

    Ao ler objetos Archive de um bucket com acesso em tempo real a objetos Archive ativado, a cobrança é baseada no volume de dados recuperados.

    Aceleração de transferência

    Se a aceleração de transferência estiver ativada e você acessar o bucket usando um endpoint de aceleração, a cobrança será baseada no volume de dados transferidos.

    PutObject

    Requisições PUT

    Cobrança baseada no número de requisições bem-sucedidas.

    Taxa de armazenamento

    Cobrança baseada na classe de armazenamento, tamanho e duração do armazenamento do objeto.

    HeadObject

    Requisições GET

    Cobrança baseada no número de requisições bem-sucedidas.

  • Para o IMM, consulte Itens de faturamento do IMM para obter preços detalhados.

    Importante

    A partir das 11:00 UTC+8 de 28 de julho de 2025, o serviço de conversão de vídeo para imagem animada do IMM deixará de ser gratuito e passará a ser pago. Para mais informações, consulte Anúncio de ajuste de faturamento do IMM.

    API

    Item faturável

    Descrição

    CreateMediaConvertTask

    MediaAnimation

    Cobrança baseada no número de quadros da imagem animada de saída.

Exemplos de parâmetros

Os exemplos a seguir usam o projeto IMM test-project e o arquivo oss://test-bucket/video-demo/brewing.mov para converter vídeo em imagem animada.

Para mais informações sobre os recursos e o uso do ApsaraVideo Media Processing, consulte Transcodificação de mídia.

Nota
  • Use a API de transcodificação de mídia para processar arquivos de vídeo no OpenAPI Explorer. Consulte os exemplos de código do sdk.

  • Não defina os parâmetros Target.URI e Target.Container para a conversão de vídeo para imagem animada.

  • Imagens animadas em GIF possuem qualidade inferior. Use WebP para obter melhor qualidade, mas observe que isso aumenta o tamanho do arquivo.

  • Defina FrameRate entre 10 e 15. Se não for definido, o valor padrão será 1 dividido por Interval.

Gerar uma miniatura animada de todo o vídeo

Configurações de transcodificação

  • Formato da imagem animada: WebP

  • Intervalo de amostragem de quadros: 1 segundo

  • Taxa de quadros da imagem animada: 15

  • Resolução da imagem animada: metade da resolução do vídeo de source

  • Método de dimensionamento: redimensionar sem preservar barras pretas. Para mais informações sobre métodos de dimensionamento, consulte Métodos de dimensionamento.

  • Caminho do arquivo de saída: oss://test-bucket/video-demo/animation.webp

  • Notificação de conclusão da transcodificação: enviar uma mensagem MNS para o tópico MNS “test-mns-topic”

Para um exemplo de sdk, consulte o OpenAPI Explorer. Os parâmetros do exemplo já estão preenchidos. Modifique-os conforme necessário antes de testar.

Parâmetros da requisição

{
  "ProjectName": "test-project",
  "Notification": {
    "MNS": {
      "TopicName": "test-mns-topic"
    }
  },
  "Sources": [
    {
      "URI": "oss://test-bucket/video-demo/brewing.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Animations": [
          {
            "Format": "webp",
            "FrameRate": 15,
            "Height": 0.5,
            "Interval": 1,
            "ScaleType": "fit",
            "URI": "oss://test-bucket/video-demo/animation.{autoext}",
            "Width": 0.5
          }
        ]
      }
    }
  ]
}

Gerar uma miniatura animada dos segundos 5 a 30 do vídeo

Configurações de transcodificação

  • Formato da imagem animada: WebP

  • Tempo inicial da amostragem de quadros: segundo 5

  • Duração da amostragem de quadros: 25 segundos

  • Intervalo de amostragem de quadros: 1 segundo

  • Taxa de quadros da imagem animada: 15

  • Resolução da imagem animada: metade da resolução do vídeo de source

  • Método de dimensionamento: redimensionar sem preservar barras pretas. Para mais informações sobre métodos de dimensionamento, consulte Métodos de dimensionamento.

  • Caminho do arquivo de saída: oss://test-bucket/video-demo/animation.webp

  • Notificação de conclusão da transcodificação: enviar uma mensagem MNS para o tópico MNS “test-mns-topic”

Para um exemplo de sdk, consulte o OpenAPI Explorer. Os parâmetros do exemplo já estão preenchidos. Modifique-os conforme necessário antes de testar.

Parâmetros da requisição

{
  "ProjectName": "test-project",
  "Notification": {
    "MNS": {
      "TopicName": "test-mns-topic"
    }
  },
  "Sources": [
    {
      "Duration": 25,
      "StartTime": 5,
      "URI": "oss://test-bucket/video-demo/brewing.mov"
    }
  ],
  "Targets": [
    {
      "Image": {
        "Animations": [
          {
            "Format": "webp",
            "FrameRate": 15,
            "Height": 0.5,
            "Interval": 1,
            "ScaleType": "fit",
            "URI": "oss://test-bucket/video-demo/animation.{autoext}",
            "Width": 0.5
          }
        ]
      }
    }
  ]
}