OSS IMG parameters, methods, and limitations - Object Storage Service: Central de Documentação do Alibaba Cloud

Parâmetros IMG

Processe imagens com um ou mais parâmetros ou agrupe-os em um estilo para processamento em lote. Estilos de imagem.

Ao especificar vários parâmetros IMG, o OSS processa a imagem na ordem indicada.

Ações	Parâmetro	Descrição
Redimensionamento de imagem	resize	Redimensiona a imagem para as dimensões especificadas.
Marca d'água	watermark	Adiciona uma marca d'água de imagem ou texto à imagem.
Recorte personalizado	crop	Recorta a imagem em um retângulo de tamanho especificado.
Ajuste de qualidade	quality	Ajusta a qualidade de imagens JPG e WebP.
Conversão de formato	format	Converte o formato da imagem.
Compressão avançada para imagens HEIF ou AVIF	format	Converte a imagem para um formato de alta compressão, como HEIF ou AVIF.
Consulta de informações da imagem	info	Recupera informações da imagem, como propriedades básicas e dados do Exchangeable Image File Format (EXIF).
Orientação automática	auto-orient	Gira automaticamente uma imagem com base nos metadados de orientação.
Recorte circular	circle	Recorta uma imagem circular de tamanho especificado, centralizada na imagem original.
Fatiamento indexado	indexcrop	Fatiada a imagem em seções ao longo do eixo x ou y e seleciona uma das fatias.
Retângulo arredondado	rounded-corners	Recorta a imagem em um retângulo com cantos arredondados de raio especificado.
Desfoque	blur	Aplica um efeito de desfoque à imagem.
Rotação	rotate	Gira a imagem no sentido horário por um ângulo especificado.
Definir modo de exibição	interlace	Ativa a renderização progressiva para uma imagem no formato JPG.
Obter matiz média	average-hue	Recupera a matiz média da imagem.
Brilho	bright	Ajusta o brilho da imagem.
Nitidez	sharpen	Aplica um efeito de nitidez à imagem.
Contraste	contrast	Ajusta o contraste da imagem.

Por exemplo, adicionar os parâmetros resize e quality ao arquivo example.jpg gera a URL https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300/quality,q_90. Configure o CDN para recuperar a imagem source ou a imagem processada durante as solicitações back-to-origin.

Back-to-origin para a imagem source

Com a filtragem de parâmetros ativada, o CDN remove todos os parâmetros após o ponto de interrogação (?) e busca a imagem source example.jpg.
Back-to-origin para a imagem processada

Com a preservação de parâmetros, o CDN mantém os parâmetros da URL e busca a imagem processada.

Configure as regras de back-to-origin do CDN com Ignorar parâmetros.

Métodos IMG

Processe imagens usando URLs de objetos, operações de API ou SDKs. Métodos de processamento de imagens.

Limitações

Item	Descrição
Formatos de imagem	A imagem source deve estar em um dos seguintes formatos: JPG, PNG, BMP, GIF, WebP, TIFF, HEIC ou AVIF. Imagens dinâmicas, como GIFs animados, aceitam apenas redimensionamento, recorte, rotação e marca d'água. Para codificar ou decodificar imagens WebP animadas, abra um ticket.
Tamanho da imagem	Tamanho máximo da imagem source: 20 MB.
Dimensões da imagem source	Rotação: largura ou altura máxima de 4.096 px. Outras operações: largura ou altura máxima de 30.000 px, com limite total de 250 milhões de pixels. O número total de pixels para imagens dinâmicas, como imagens GIF, é `width height number of frames`, enquanto para imagens estáticas, como imagens PNG, é `width * height`.
Dimensões da imagem de destino	Para imagens WebP, a largura e a altura não podem exceder 16.383 px. Para imagens HEIC, a largura e a altura não podem exceder 4.096 px. Para imagens AVIF, a largura não pode exceder 4.096 px e o número total de pixels não pode ultrapassar 9.437.184.
Redimensionamento de imagem	Após o redimensionamento, a largura ou altura não pode exceder 16.384 px e o total de pixels não pode ultrapassar 16.777.216.
Estilos de imagem	Limite: 50 estilos de imagem por bucket. Para solicitar mais, abra um ticket. Nota Um único estilo de imagem pode incluir vários parâmetros IMG para operações complexas. Estilos de imagem.
Capacidade de processamento	Throughput de processamento de imagens por segundo (com base no tamanho da imagem source) China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou) e China (Shenzhen): 20 MB/s. Outras regiões: 2 MB/s. Consultas por segundo (QPS) China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou) e China (Shenzhen): 50. Outras regiões: 5. Nota Para cenários computacionalmente intensivos (codificação de WebP, AVIF ou HEIF acima de 1080p) ou cargas de trabalho que excedam esses limites, entre em contato com o suporte técnico para avaliar os limites adequados ao seu caso de uso.

Faturamento

O IMG gera as seguintes taxas:

Taxas de solicitação

Cada operação gera uma solicitação GetObject, sujeita a uma taxa por solicitação. Taxas de solicitação.
Taxas de tráfego

As taxas de tráfego de saída são baseadas no tamanho da imagem processada. Taxas de tráfego.

Versões do IMG

O IMG possui uma versão de API nova e uma antiga. Este documento aborda a nova versão; a versão antiga não recebe mais atualizações. Versões nova e antiga do IMG e sua compatibilidade.