Todos os produtos
Search
Central de documentação

CDN:Edição de imagens

Última atualização: Jul 01, 2026

Ative recursos básicos como conversão adaptativa para WebP, rotação automática (apenas autocorreção) e compactação automática diretamente no console. Para operações avançadas, como recorte e aplicação de marca d'água, adicione parâmetros de edição de imagem à URL da solicitação.

A edição de imagens do CDN, a edição de imagens do DCDN e o Processamento de Imagens (IMG) do Object Storage Service (OSS) são três recursos distintos. A edição de imagens é gratuita até novo aviso.

Conversão de formato

A conversão entre formatos pode aumentar o tamanho do arquivo, pois cada formato utiliza algoritmos de compactação diferentes. Por exemplo, converter JPEG para WebP, JPEG para PNG ou PNG para WebP pode resultar em um arquivo maior. Para reduzir o tamanho do arquivo de saída, defina o parâmetro quality e diminua a qualidade da imagem.

Ativar a edição de imagens

  1. Faça login no console do CDN.

  2. No painel de navegação à esquerda, clique em Domain Names.

  3. Na página Domain Names, localize o nome de domínio desejado e clique em Gerencie na coluna Actions.

  4. No painel de navegação do domínio, clique em Optimization.

  5. Na seção Image Editing, ative a chave Image Editing e selecione os formatos de imagem que deseja converter.

    Nota
    • O recurso de edição de imagens é ativado após a seleção dos formatos suportados. Depois de ativado, os parâmetros de edição de imagem na URL entram em vigor quando você processa imagens com URLs de arquivo.

    • É possível decidir se deseja ativar a conversão automática para WebP, a rotação automática (apenas para autocorreção) e a compactação automática no console.

    Parâmetro

    Descrição

    Supported Image Formats

    Selecione os formatos de imagem que deseja converter. Este parâmetro é obrigatório e permite a seleção de múltiplos formatos.

    Automatic Conversion to WebP

    Se este recurso estiver ativado e o cabeçalho Accept da solicitação contiver image/webp, o Alibaba Cloud CDN converte automaticamente as imagens de outros formatos para WebP antes de armazená-las em cache.

    Nota

    A ativação deste recurso pode diminuir temporariamente a taxa de acerto do cache. A taxa retornará ao normal após um curto período. Não ative este recurso durante os horários de pico de negócios.

    Automatic Rotation

    Ativa a correção automática da orientação da imagem.

    Nota
    • A rotação automática aplica-se apenas quando o parâmetro auto-orient é utilizado.

    • A ativação deste recurso pode diminuir temporariamente a taxa de acerto do cache. A taxa retornará ao normal após um curto período. Não ative este recurso durante os horários de pico de negócios.

    Automatic Compression

    Quando ativado, este recurso permite que o Alibaba Cloud CDN compacte imagens e reduza o uso de largura de banda sem alterar sua resolução, dimensões ou formato.

    • 0 (padrão): Desativa o recurso.

    • 1 a 100: Ativa o recurso. Por exemplo, um valor de 90 significa que a qualidade da imagem é mantida em 90% da original.

    Nota

    Este recurso suporta apenas os formatos JPEG e WebP.

    Source Image Cache

    Se uma imagem de origem tiver várias cópias convertidas, ativar o cache da imagem de origem reduz o número de solicitações à origem.

  6. Clique em OK para concluir a configuração.

Processar imagens usando URLs de arquivo

  1. Selecione os formatos de imagem suportados seguindo as instruções em Ativar a edição de imagens.

  2. Adicione parâmetros à URL da solicitação para executar operações personalizadas.

    • Formato: http://example.com/image_01.png?image_process=action,param_value/action,param_value

      Campo

      Descrição

      example.com

      Seu nome de domínio acelerado.

      image_01.png

      O nome da imagem.

      image_process

      Um parâmetro fixo que indica uma operação de edição de imagem.

      action,param_value

      A ação e o valor que definem uma operação. Especifique múltiplas operações separando-as com barras (/). O Alibaba Cloud CDN as aplica na ordem em que estão listadas. Para mais informações sobre os parâmetros suportados, consulte Parâmetros de edição de imagem.

    • Exemplo: http://example.com/image_01.png?image_process=resize,w_200/rotate,90/format,webp. Resultado: A imagem é primeiro redimensionada proporcionalmente para uma largura de 200 pixels, depois rotacionada 90° no sentido horário e, finalmente, salva no formato WebP.

Parâmetros de edição de imagem

Adicione parâmetros a uma url de solicitação para realizar diversas operações de edição de imagem. É possível usar um ou mais parâmetros em uma única url.

Recurso de edição de imagem

Parâmetro

Descrição

Conversão de formato

format

Converte o formato da imagem.

Ajuste de qualidade

quality

Ajusta a qualidade da imagem.

Recorte de imagem

crop

Recorta a imagem para um tamanho especificado.

Redimensionamento de imagem

resize

Redimensiona a imagem para as dimensões especificadas. O aumento de escala não é suportado.

Rotação de imagem

  • Rotação automática: auto-orient

  • Rotação específica: rotate

Corrige automaticamente a orientação de uma imagem com tag de orientação ou rotaciona uma imagem no sentido horário por um ângulo especificado.

Ajuste de cor

  • Brilho: bright

  • Contraste: contrast

  • Nitidez: sharpen

Ajusta o brilho, o contraste e a nitidez da imagem.

Marca d'água

watermark

Adiciona uma marca d'água de imagem ou texto a uma imagem.

Recuperação de informações da imagem

info

Recupera informações da imagem, como largura, altura, formato e qualidade.