Operaciones admitidas

En esta sección, se enumeran las operaciones compatibles con la optimización de imágenes de Cloud CDN. La tabla incluye parámetros, como operación, sintaxis, atributos, descripción y ejemplos, que te ayudan a crear tu consulta imop.

La optimización de imágenes de Cloud CDN admite un conjunto de operaciones que te permiten transformar tus imágenes, como cambiar el tamaño, recortar y escalar. Cada operación tiene su propia sintaxis, atributos compatibles y restricciones.

En esta página, se enumeran las operaciones compatibles con la optimización de imágenes de Cloud CDN con ejemplos que te ayudan a crear tu consulta imop.

Operación Sintaxis y ejemplo Atributos Descripción

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125
  • Tipo width: Número entero (rango: 1–8192)
  • Tipo height: Número entero (rango: 1–8192)

El width * height máximo no puede superar los 67 mpx (67,108,864 píxeles).

  • Tipo de escalamiento (opcional): enum, valores: proportional, stretch.
    		•

    Esta operación no conserva la relación de aspecto cuando especificas los parámetros de ancho y alto. Si omites alguna dimensión, la optimización de imágenes de Cloud CDN calcula la otra para mantener la relación de aspecto.

    De forma predeterminada, la optimización de imágenes aplica una estrategia estricta de solo reducción. Si especificas el parámetro scaling=stretch se habilita el aumento de escala, pero el sistema no lo permite si especificas solo un parámetro de tamaño.

    Scale

    ?imop=Scale,ratio=<scale_ratio>

    https://www.example.com/image.jpg?imop=Scale,ratio=0.5

    		 ratio
    • Tipo: Flotante (limitado a 2 dígitos decimales)
    • Restricción: 0 < value

    Esta operación escala la imagen por un factor específico y aplica solo la reducción de escala. Es mutuamente excluyente con las operaciones Resize y Crop.

    Si incluyes la operación Scale con las operaciones Resize o Crop en una sola solicitud, el sistema muestra un error.

    Crop

    ?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

    https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

    		 shape
    • Tipo: Cadena (rectangle, circle)
    • Valor predeterminado: rectangle
    • Dependencia: Se debe usar con el parámetro crop. Un valor no válido mostrará HTTP 400.
    left, right, top, bottom
    • Tipo: Flotante
    • Rango: 0.0 a 1.0, máximo 3 decimales
    • Valor predeterminado: 0.0, 1.0, 0.0, 1.0
    snap_to_x, snap_to_y
    • Tipo: Número entero
    • Rango: 0 o más
    • Valor predeterminado: 0
    • Restricción: Es obligatorio incluir al menos uno de los siguientes: left, right, top, bottom.

    Esta operación recorta la imagen según los marcadores regionales. Si especificas un valor no válido para el parámetro shape, el sistema muestra un HTTP 400 Bad Request.

    Las coordenadas de recorte se ajustan automáticamente al múltiplo más cercano del valor snap_to_x o snap_to_y especificado.

    Canvas

    ?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

    https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

    		 width, height
    • Tipo: Número entero
    • Rango: 1–8192
    • El ancho x alto máximo no puede superar los 67,108,864 píxeles.
    gravity
    • Tipo: Cadena
    • Valores: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
    • Valor predeterminado: center
    background_color
    • Tipo: Cadena
    • Formato: Códigos hexadecimales de 3, 4 o 6 dígitos
    • Valor predeterminado: 000000 (negro).

    Esta operación mejora las imágenes agregando un diseño de fondo de dimensiones y color especificados El parámetro gravity dicta la ubicación de la imagen interna en este lienzo de fondo.

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

    https://www.example.com/image.jpg?imop=Rotate,degrees=90

    		 degrees
    • Tipo: Número entero
    • Valores permitidos: 90, 180, 270.

    Esta operación rota la imagen objetivo en el sentido de las manecillas del reloj.

    Mirror

    ?imop=Mirror,flip=<flip>

    https://www.example.com/image.jpg?imop=Mirror,flip=h

    		 flip
    • Tipo: Cadena
    • Valores permitidos: h (horizontal), v (vertical), hv (horizontal y vertical).

    Esta operación refleja la imagen de forma horizontal, vertical o ambas.

    Compress

    ?imop=Compress,strength=<value>

    https://www.example.com/image.jpg?imop=Compress,strength=medium

    		 strength
    • Tipo: Cadena
    • Valores permitidos: very_weak, weak, medium, strong, very_strong.
    • Restricción: Solo se admite para jpeg, avif y webp. Los valores fuera de este rango muestran HTTP 400.

    Esta operación comprime la imagen disminuyendo la calidad de la imagen objetivo. El parámetro strength te permite controlar el nivel de compresión de imagen activo.

    Convert

    ?imop=Convert,format=<format>

    https://www.example.com/image.jpg?imop=Convert,format=webp

    		 format
    • Tipo: Cadena.
    • Valores permitidos: jpeg, png, webp, avif, gif
    • Restricción: Cualquier otro valor no incluido generará un error de procesamiento.

    Esta operación cambia el formato de entrega final de la imagen. Si hay un conflicto de procesamiento con la especificación del encabezado ACCEPT entrante del navegador, el sistema muestra un error HTTP 406 Not Acceptable.

    Metadata

    ?imop=Metadata,preserve=<preserve>

    https://www.example.com/image.jpg?imop=Metadata,preserve=none

    		 preserve
    • Tipo: Cadena
    • Valores permitidos: none, copyright, max
    • Valor predeterminado: copyright

    Esta operación controla cómo se controlan las propiedades de metadatos de la imagen durante la ejecución:

    none: Quita todas las propiedades de metadatos.

    max: Conserva todos los campos excepto la orientación EXIF y los perfiles de color que se aplican en la transformación

    .

    copyright: Conserva solo los campos Author, Copyright y Caption.

    Tone

    ?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

    https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50
    • brightness
      • Tipo: Número entero
      • Rango: -100 a 100
    • contrast
      • Tipo: Número entero
      • Rango: -100 a 100
    • saturation
      • Tipo: Número entero
      • Rango: -100 a 100

    Esta operación modifica de forma dinámica los brightness, contrast, y saturation niveles de una imagen. Si omites un parámetro específico o lo configuras en 0, el sistema no cambia ese atributo. Si configuras la saturación en -100, se fuerza la conversión a escala de grises.

    Sharpen

    ?imop=Sharpen,strength=<sharpness>

    https://www.example.com/image.jpg?imop=Sharpen,strength=50

    		 strength
    • Tipo: Número entero
    • Rango: 0 a 100

    Esta operación aumenta la nitidez de la imagen.

    Blur

    ?imop=Blur,strength=<blur_size>

    https://www.example.com/image.jpg?imop=Blur,strength=50

    		 strength
    • Tipo: Número entero
    • Rango: 0 a 100

    Esta operación aplica un filtro de desenfoque localizado en toda la imagen.

    Freeze

    ?imop=freeze,frame=<frame>

    https://www.example.com/image.gif?imop=freeze,frame=0

    		 frame
    • Tipo: Número entero
    • Rango: 0 a 100.

    Esta operación extrae un solo fotograma estático de una secuencia de imágenes animadas , como un GIF animado. El parámetro frame especifica el índice de fotograma exacto que se extraerá.

    ¿Qué sigue?