API del Acelerador de Sitios

Este texto fue traducido usando IA. Si deseas ver el texto original en inglés, haz clic aquí.

Site Accelerator de Jetpack es una Red de Distribución de Contenidos (CDN) en WordPress.com, optimizada para acelerar tu sitio entregando imágenes y archivos estáticos más rápido. Esta guía explica cómo usar su API y los argumentos disponibles.

El CDN de Site Accelerator se habilita automáticamente en los sitios con los planes Business y Commerce de WordPress.com.

Argumentos de consulta

Puedes recortar, redimensionar y filtrar imágenes servidas por el CDN de Site Accelerator usando los siguientes parámetros de consulta GET.

GET?w=

Establece el ancho (width) de una imagen en píxeles:

?w=300

Imagen del letrero del Fox Oakland Theater con un semáforo en verde en primer plano y una multitud de personas caminando por la calle.

GET?h=

Establece la altura (height) de una imagen en píxeles:

?h=200

Primer plano de flores de lavanda púrpura con una abeja recolectando néctar.

GET?crop=x,y,w,h

Recorta una imagen mediante porcentajes de desplazamiento en x, desplazamiento en y, ancho y alto (x,y,w,h). Se utilizan porcentajes para que no sea necesario recalcular el recorte al transformar la imagen de otras formas, como al redimensionarla.

Por ejemplo, la siguiente imagen toma un rectángulo del 60% por 60% de la imagen de origen comenzando con un desplazamiento del 12% desde la izquierda y del 25% desde la parte superior.

?crop=12,25,60,60

Primer plano de recipientes de vidrio con varias salsas o mermeladas de colores, expuestos sobre un mantel blanco, con pequeñas cucharas a su lado.

La siguiente imagen toma un cuadrado de 788 por 788 píxeles comenzando en 160 por 160.

?crop=160px,160px,788px,788px

Primer plano de tres recipientes de vidrio con tapas abovedadas, cada uno con salsas o mermeladas de diferentes colores, colocados sobre un mantel blanco.

También puedes mezclar los tipos de parámetros, por ejemplo un rectángulo de 1400 píxeles por 60% de la imagen comenzando en 160 píxeles por 25%.

?crop=160px,25,1400px,60

Una fila de pequeños frascos de vidrio con salsas o condimentos de colores, cada uno con una tapa de vidrio, colocados sobre un mantel blanco con cucharas de plata a su lado.

GET?resize=

Redimensiona y recorta una imagen a las dimensiones exactas de ancho,alto en píxeles. Establece el primer número lo más cercano posible al tamaño objetivo y luego recorta el resto. La dirección en la que se redimensiona y recorta depende de las relaciones de aspecto de la imagen original y del tamaño objetivo.

?resize=400,220

Vista panorámica de un paisaje costero con colinas, una carretera sinuosa y un cielo azul despejado.

?resize=200,400

Un gato atigrado apoyando sus patas delanteras en la barandilla de un balcón, con un fondo difuminado de vegetación.

Esto es útil para tomar una imagen de cualquier tamaño y hacer que encaje en una ubicación determinada perdiendo la menor cantidad posible de la imagen.

GET?fit=

Ajusta una imagen dentro de un cuadro contenedor de dimensiones ancho, alto. Se mantiene la relación de aspecto de la imagen.

?fit=300,300

Una escultura de esfera metálica reflectante sobre una superficie mojada, que captura el paisaje urbano y los árboles circundantes.

?fit=300,300

Una botella de whiskey Jameson Distillery Reserve 12 junto a una copa de vino tinto sobre una mesa de comedor.

Por ejemplo, fit=100,100 en una imagen horizontal con dimensiones de 400×300 dará como resultado una imagen de 100×75, mientras que fit=100,100 en una imagen vertical con dimensiones de 300×400 dará como resultado una imagen de 75×100.

GET?lb=

Añade un efecto de letterboxing negro a las imágenes, escalándolas a las dimensiones de ancho, alto mientras se mantiene la relación de aspecto y se rellena el resto con negro.

Imagen original

Vista panorámica de un mar en calma con costas rocosas bajo un cielo nublado, mostrando una línea costera distante con montañas.

?lb=310,250

Vista panorámica de una costa rocosa con olas rompiendo contra las rocas, bajo un cielo nublado, con montañas distantes y un pueblo costero al fondo.

GET?ulb=

Elimina el efecto de letterboxing negro de las imágenes con ulb. Esta función acepta un solo argumento, true.

Imagen original

Imagen en blanco y negro de dos hombres entre una multitud, uno con una gorra que dice 'RIP G' y el otro observando.

?ulb=true

Imagen en blanco y negro de dos personas en un ambiente animado, una con una gorra que dice 'RIP' y sonriendo, mientras la otra parece pensativa.

GET?filter=

El parámetro filter se utiliza para aplicar uno de varios filtros. Los valores válidos son: negate, grayscale, sepia, edgedetect, emboss, blurgaussian, blurselective, meanremoval.

Imagen original

Una taza de té con una bolsita sobre un platillo, acompañada de un trozo de pastelería y una tetera de fondo.

?filter=negate

Una imagen invertida de una taza con una bolsita de té sobre un platillo, acompañada de una pastelería azul y una tetera.

?filter=grayscale

Una imagen en blanco y negro de una taza de café con una etiqueta de bolsita de té, un trozo de pan y una tetera de fondo, colocados sobre una superficie de madera.

?filter=sepia

Una taza de café con una bolsita de té sobre el platillo, acompañada de una galleta y una tetera de fondo.

?filter=edgedetect

Una taza de café sobre un platillo con una galleta, acompañada de una tetera, con una etiqueta en la taza.

?filter=emboss

Taza de café con una pastelería en un plato, un sobre de azúcar en la taza y una tetera de fondo, con filtro artístico aplicado.

?filter=blurgaussian

Una taza de té con una etiqueta de bolsita, acompañada de una tetera y un trozo de pan sobre un platillo, colocados en una mesa de madera.

?filter=blurselective

Una taza de café con una pegatina de logotipo, acompañada de un plato pequeño con una pastelería, una tetera y un sobre de azúcar, todo colocado sobre una mesa de madera.

?filter=meanremoval

Una taza de té con una bolsita apoyada en el borde, acompañada de una pastelería en un plato, sobre una mesa de madera.

GET?brightness=

Ajusta el brillo de una imagen. Los valores válidos van de -255 a 255, donde -255 es negro y 255 es blanco. Cuanto mayor sea el valor, más brillante será la imagen. El valor predeterminado es cero.

?brightness=-40

Un pájaro en vuelo contra un cielo gris.

?brightness=0

Un pájaro volando contra un cielo gris nublado.

?brightness=80

Un pájaro blanco en vuelo contra un fondo blanco brillante.

GET?contrast=

Ajusta el contraste de una imagen. Los valores válidos van de -100 a 100. El valor predeterminado es cero.

?contrast=-50

Un pájaro volando contra un cielo nublado.

?contrast=0

?contrast=50

Un pájaro en vuelo contra un fondo blanco.

GET?colorize=

Añade tonos de color a una imagen con colorize pasando una lista separada por comas de rojo, verde y azul (RGB). Por ejemplo, valores como 255,0,0 (rojo), 0,255,0 (verde), 0,0,255 (azul).

?colorize=100,0,0

?colorize=0,100,0

?colorize=0,0,100

Un faro sobre un acantilado rocoso rodeado de vegetación con un cielo azul de fondo.

GET?smooth=

El parámetro smooth se puede utilizar para suavizar la imagen.

Imagen original

Vista de cerca del motor y la hélice de un avión vintage con esquema de colores naranja y blanco, mostrando los componentes del motor y un reflejo del paisaje.

?smooth=1

Vista de cerca de un avión vintage naranja y blanco con hélice, contra un cielo azul despejado.

Según el manual de PHP, la función aplica una matriz de convolución de 9 celdas donde el píxel central se pondera con el valor del primer argumento, y todos los píxeles circundantes tienen un peso de 1. El resultado se normaliza dividiendo por el peso total. En términos más simples, un valor de 0 produce el máximo suavizado, mientras que valores más altos reducen el efecto de suavizado. Valores de aproximadamente 2048 o más tienen poco o ningún impacto visible.

GET?zoom=

Usa zoom para dimensionar imágenes para dispositivos con alta proporción de píxeles y navegadores con zoom aplicado. No está disponible para usar con crop. Zoom está diseñado para ser utilizado por scripts como devicepx.js que establecen automáticamente el nivel de zoom. Los niveles de zoom válidos son 1, 1.5, 2-10.

Imagen original

Un niño sosteniendo un palo con humo elevándose, frente a una multitud durante una celebración al aire libre, con montañas de fondo.

?zoom=2

Una niña vestida con un vestido azul sostiene un manojo alto de palos encendidos mientras una bandera etíope ondea de fondo. La escena se desarrolla en una zona rural con un grupo de espectadores al fondo.

GET?quality=

Usa este parámetro para gestionar la calidad de salida de las imágenes. Los valores válidos están entre 10 y 100. El grado de compresión depende de la imagen, su naturaleza con o sin pérdida, y las capacidades del navegador web que realiza la solicitud.

Para imágenes sin pérdida, proporcionar un valor de calidad inferior a 100 resultará en una imagen con pérdida siempre que el navegador solicitante admita este tipo de imagen. A continuación se muestra un ejemplo que ilustra la conversión de una imagen PNG no transparente (sin pérdida) a JPEG (o WebP con pérdida si el navegador lo admite) cuando se especifica la calidad.

Si no se especifica la calidad, photon intentará preservar la calidad original.

Imagen original

Imagen en primer plano de dos hormigas negras interactuando sobre un trozo de madera con un fondo verde desenfocado.

?quality=50

Primer plano de dos hormigas enfrentándose sobre una superficie de madera, con un fondo natural desenfocado.

Imagen png original

?quality=60

GET?allow_lossy=

Usa este parámetro para controlar si el CDN de imágenes puede servir una versión con compresión con pérdida de una imagen. Cuando se especifica allow_lossy=1, el CDN intentará entregar un formato con pérdida (por ejemplo, JPEG o WebP) si el navegador solicitante lo admite.

A continuación se muestra un ejemplo que demuestra cómo una imagen PNG no transparente (sin pérdida) puede convertirse a JPEG (o WebP con pérdida si el navegador lo admite) cuando se incluye allow_lossy=1 en la solicitud.

Imagen png original

?allow_lossy=1

GET?strip=

Usa la funcionalidad strip para controlar cómo se preservan los metadatos. Los perfiles de color siempre se aplican y se eliminan, pero otros metadatos pueden conservarse. Todos los datos se eliminan de forma predeterminada, aplicándose primero cualquier dato de orientación existente a la imagen. Hay 2 valores válidos para este parámetro:

all: elimina todos los datos superfluos (este es el valor predeterminado).
none: preserva Exif, IPTC y XMP.

Imagen original

Primer plano de flores amarillas con un fondo verde.

?strip=none

Primer plano de flores amarillas vibrantes entre follaje verde, tomada desde arriba.

Última actualización: mayo 18, 2026