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 |
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
Converter uma imagem original para o formato JPG e ativar exibição progressiva
Converter uma imagem original para o formato WebP e redimensioná-la
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.



