Todos os produtos
Search
Central de documentação

Object Storage Service:Conversão de formato de imagem

Última atualização: Oct 14, 2026

Converta o formato das imagens armazenadas no Object Storage Service (OSS) em tempo real adicionando parâmetros à URL da imagem, sem necessidade de processamento offline. Este tópico descreve os parâmetros e fornece exemplos para conversão de formato de imagem.

Casos de uso

  • Adaptação a dispositivos e plataformas: Converta imagens para diferentes formatos para garantir compatibilidade e exibição ideal em diversos dispositivos.

  • Redução de custos de armazenamento: Alguns formatos de imagem, como WebP, possuem tamanhos de arquivo menores mantendo a qualidade visual. Converta imagens para esses formatos para reduzir o uso de armazenamento e diminuir custos.

  • Padronização de formatos de ativos: Converta todas as imagens carregadas para um único formato padrão (como WebP) para simplificar o gerenciamento de ativos e os pipelines de entrega, prática comum em aplicações de e-commerce, redes sociais e notícias.

Observações de uso

  • Se uma solicitação de processamento de imagem incluir uma operação de redimensionamento, coloque o parâmetro de conversão de formato ao final dos parâmetros de processamento. Por exemplo, image/resize,w_100/format,jpg.

  • Caso a solicitação inclua operações de redimensionamento e marca d'água, adicione o parâmetro de conversão de formato após o parâmetro de redimensionamento. Por exemplo, image/resize,w_100/format,jpg/watermark,....

  • Ao converter uma imagem sem canal alfa para um formato que o suporte (como PNG ou WebP), as áreas transparentes resultantes serão preenchidas com branco por padrão. Observe que o OSS não oferece suporte ao preenchimento da área transparente com preto.

  • Na conversão para o formato WebP, a largura e a altura da imagem não devem exceder 16.383 px. Caso contrário, a conversão falhará.

Métodos

Processe imagens por meio de parâmetros de URL, SDKs ou APIs REST. O processamento via URL está disponível apenas para imagens acessíveis publicamente; para imagens privadas, utilize um SDK ou chame a API diretamente. Para mais informações, consulte Image processing methods.

Public-read images

Para imagens de leitura pública, adicione parâmetros de processamento diretamente à URL da imagem. A imagem processada pode então ser acessada pela URL gerada.

Para processar uma imagem de leitura pública, adicione o parâmetro ?x-oss-process=image/format,parameter_value à URL da imagem. Substitua parameter_value pelos parâmetros e valores necessários. Também é possível combinar vários parâmetros.

URL da imagem original

URL da imagem com parâmetros de processamento

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif?x-oss-process=image/format,png

Private images

Converta o formato de imagens privadas usando SDKs do Alibaba Cloud ou APIs REST.

Use Alibaba Cloud SDKs

As seções a seguir fornecem amostras de código que mostram como converter formatos de imagem com SDKs comuns. Para amostras de código que utilizam outros SDKs, consulte SDK overview.

Java

É necessário o Java SDK 3.17.4 ou posterior.

GET /oss.jpg?x-oss-process=image/format,png HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

PHP

É necessário o PHP SDK 2.7.0 ou posterior.

GET /oss.jpg?x-oss-process=image/format,png HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

Python

É necessário o Python SDK 2.18.4 ou posterior.

GET /oss.jpg?x-oss-process=image/format,png HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

Go

É necessário o Go SDK 3.0.2 ou posterior.

GET /oss.jpg?x-oss-process=image/format,png HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

Use a REST API

Se o seu negócio exigir um alto nível de personalização, chame as APIs RESTful diretamente. Para chamar uma API diretamente, você deve incluir o cálculo da assinatura no seu código. Para mais informações sobre como calcular o cabeçalho Authorization, consulte Signature Version 4 (Recommended).

Especifique parâmetros de formato na chamada GetObject para processar uma imagem. Para mais informações, consulte GetObject.

GET /oss.jpg?x-oss-process=image/format,png HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: AuthorizationValue

Parâmetros

Ação: format

Valor

Descrição

jpg

Salva a imagem original no formato JPG.

Importante

Não é possível salvar uma imagem no formato HEIC que possua canal alfa para o formato JPG.

png

Salva a imagem original no formato PNG.

webp

Salva a imagem original no formato WebP.

Nota

A largura e a altura da imagem não devem exceder 16.383 px.

bmp

Salva a imagem original no formato BMP.

gif

Se a imagem original estiver no formato GIF, ela será salva nesse mesmo formato. Caso contrário, será salva em seu formato original.

tiff

Salva a imagem original no formato TIFF.

heic

Salva a imagem original no formato HEIF.

Nota

O formato HEIF é suportado apenas nas regiões China (Zhangjiakou), China (Shanghai), China (Hangzhou), China (Shenzhen), China (Beijing), Singapore e US (Virginia).

avif

Salva a imagem original no formato AVIF.

Nota

O formato AVIF é suportado apenas nas regiões China (Zhangjiakou), China (Shanghai), China (Hangzhou), China (Shenzhen), China (Beijing), Singapore e US (Virginia).

Exemplos

Converter uma imagem original para o formato PNG

Os parâmetros de processamento são:

  • Converter a imagem para o formato PNG: format,png

Para imagens de leitura e gravação públicas, adicione ?x-oss-process=image/format,png ao final da URL da imagem. O OSS processará a imagem em tempo real e retornará o resultado. Se desejar converter o formato de uma imagem privada, consulte Private images.

Exemplo

O exemplo a seguir mostra como converter uma imagem GIF para o formato PNG anexando o parâmetro ?x-oss-process=image/format,png à URL da imagem original:

Imagem original

Imagem processada

gif

png

URL da imagem original:

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif

URL de processamento de imagem: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif?x-oss-process=image/format,png

Converter uma imagem original para o formato JPG e ativar exibição progressiva

Os parâmetros de processamento são:

  • Converter a imagem para o formato JPG: format,jpg

  • Ativar exibição progressiva para a imagem: interlace,1

Para imagens de leitura e gravação públicas, adicione ?x-oss-process=image/interlace,1/format,jpg ao final da URL da imagem. O OSS processará a imagem em tempo real e retornará o resultado. Se desejar converter o formato de uma imagem privada, consulte Private images.

Exemplo

O exemplo a seguir mostra como converter uma imagem GIF para o formato JPG e ativar a exibição progressiva anexando o parâmetro ?x-oss-process=image/interlace,1/format,jpg à URL da imagem original:

Imagem original

Imagem processada

gif

image

URL da imagem original:

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif

URL de processamento de imagem: https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif?x-oss-process=image/interlace,1/format,jpg

Converter uma imagem original para o formato WebP e redimensioná-la

Os parâmetros de processamento são:

  • Converter a imagem para o formato WebP: format,webp

  • Redimensionar a imagem para uma largura de 200 px: resize,w_200

Para imagens de leitura e gravação públicas, adicione ?x-oss-process=image/resize,w_200/format,webp ao final da URL da imagem. O OSS processará a imagem em tempo real e retornará o resultado. Se desejar converter o formato de uma imagem privada, consulte Private images.

Exemplo

O exemplo a seguir mostra como redimensionar uma imagem GIF original para uma largura de 200 px e convertê-la para o formato WebP anexando o parâmetro x-oss-process=image/resize,w_200/format,webp à URL da imagem original:

Imagem original

Imagem processada

gif

URL da imagem original:

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif

URL de processamento de imagem:

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.gif?x-oss-process=image/resize,w_200/format,webp

Perguntas frequentes

Como controlar a qualidade da imagem convertida?

Cada formato de imagem possui uma configuração de qualidade padrão. Se você não especificar o parâmetro de qualidade durante a conversão de formato, o OSS aplicará esse padrão.

Para melhorar a qualidade da imagem, defina a qualidade como 100 durante a conversão de formato, por exemplo, usando ?x-oss-process=image/quality,Q_100. Para mais informações sobre conversão de qualidade, consulte Quality conversion.

O processo de conversão de formato de imagem afeta a velocidade de carregamento da página?

A conversão de formato de imagem é realizada em tempo real. Embora a primeira solicitação possa apresentar um leve atraso de processamento, o formato de imagem resultante, menor e mais eficiente (como WebP), geralmente leva a tempos de carregamento subsequentes mais rápidos e melhora o desempenho geral da página.

Posso converter uma imagem GIF para o formato MP4?

Para converter uma imagem GIF para o formato MP4, envie um ticket para solicitar este recurso.