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.

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.
NotaTambé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.
ImportanteA 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.
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.webpNotificaçã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.webpNotificaçã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
}
]
}
}
]
}