Procesamiento de imágenes (IMG) - Object Storage Service - Centro de documentación de Alibaba Cloud

Agregue parámetros de IMG a las solicitudes GetObject para procesar imágenes almacenadas en OSS. Puede cambiar el tamaño, recortar, añadir marcas de agua, convertir formatos, entre otras operaciones.

Parámetros de IMG

Procese imágenes con uno o varios parámetros, o agrúpelos en un estilo para el procesamiento por lotes. Image styles.

Si especifica varios parámetros de IMG, OSS procesa la imagen en el orden indicado.

Acciones	Parámetro	Descripción
Image resizing	resize	Cambia el tamaño de la imagen a las dimensiones especificadas.
Watermarking	watermark	Añade una marca de agua de imagen o texto a la imagen.
Custom cropping	crop	Recorta la imagen en un rectángulo del tamaño especificado.
Quality adjustment	quality	Ajusta la calidad de las imágenes JPG y WebP.
Format conversion	format	Convierte el formato de la imagen.
Advanced compression for HEIF or AVIF images	format	Convierte la imagen a un formato de alta compresión, como HEIF o AVIF.
Query image information	info	Recupera información de la imagen, como propiedades básicas y datos de Exchangeable Image File Format (EXIF).
Auto orientation	auto-orient	Rota automáticamente una imagen según sus metadatos de orientación.
Circular crop	circle	Recorta una imagen circular del tamaño especificado, centrada en la imagen original.
Indexed slice	indexcrop	Divide la imagen en secciones a lo largo del eje x o del eje y y selecciona una de ellas.
Rounded rectangle	rounded-corners	Recorta la imagen en un rectángulo con esquinas redondeadas de un radio especificado.
Blur	blur	Aplica un efecto de desenfoque a la imagen.
Rotation	rotate	Rota la imagen en sentido horario según un ángulo especificado.
Set display mode	interlace	Habilita la representación progresiva para una imagen en formato JPG.
Get average hue	average-hue	Recupera el tono promedio de la imagen.
Brightness	bright	Ajusta el brillo de la imagen.
Sharpen	sharpen	Aplica un efecto de nitidez a la imagen.
Contrast	contrast	Ajusta el contraste de la imagen.

Por ejemplo, al agregar los parámetros resize y quality a example.jpg se genera la 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 CDN para recuperar la imagen original o la procesada durante las solicitudes de retorno al origen.

Retorno al origen para la imagen original

Con el filtrado de parámetros habilitado, CDN elimina todos los parámetros después del signo de interrogación (?) y obtiene la imagen original example.jpg.
Retorno al origen para la imagen procesada

Con la conservación de parámetros, CDN mantiene los parámetros de la URL y obtiene la imagen procesada.

Configure las reglas de retorno al origen de CDN con Ignore parameters.

Métodos de IMG

Procese imágenes mediante URL de objetos, operaciones de API o SDK. Image processing methods.

Límites

Elemento	Descripción
Formatos de imagen	La imagen original debe estar en uno de los siguientes formatos: JPG, PNG, BMP, GIF, WebP, TIFF, HEIC o AVIF. Para imágenes dinámicas, como los GIF animados, solo son compatibles cambio de tamaño, recorte, rotación y marca de agua. Para codificar o decodificar imágenes WebP animadas, envíe un ticket.
Tamaño de imagen	Tamaño máximo de la imagen original: 20 MB.
Dimensiones de la imagen original	Rotación: el ancho o alto máximo es de 4,096 px. Otras operaciones: el ancho o alto máximo es de 30,000 px, con un límite total de 250 millones de píxeles. El número total de píxeles para imágenes dinámicas, como las imágenes GIF, es `width height number of frames`, mientras que para imágenes estáticas, como las imágenes PNG, es `width * height`.
Dimensiones de la imagen destino	Para imágenes WebP, el ancho y el alto no pueden exceder los 16,383 px. Para imágenes HEIC, el ancho y el alto no pueden exceder los 4,096 px. Para imágenes AVIF, el ancho no puede exceder los 4,096 px y el número total de píxeles no puede superar los 9,437,184.
Cambio de tamaño de imagen	Tras el cambio de tamaño, el ancho o el alto no pueden exceder los 16,384 px, y el total de píxeles no puede superar los 16,777,216.
Estilos de imagen	Máximo: 50 estilos de imagen por bucket. Para solicitar más, envíe un ticket. Nota Un solo estilo de imagen puede incluir varios parámetros de IMG para operaciones complejas. Image styles.
Capacidad de procesamiento	Throughput de procesamiento de imágenes por segundo (según el tamaño de la imagen original) China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou) y China (Shenzhen): 20 MB/s. Otras regiones: 2 MB/s. Consultas por segundo (QPS) China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou) y China (Shenzhen): 50. Otras regiones: 5. Nota Para escenarios de uso intensivo de cómputo (codificación de WebP, AVIF o HEIF superior a 1080p) o cargas de trabajo que superen estos límites, póngase en contacto con soporte técnico para evaluar los límites de su caso de uso.

Facturación

IMG genera los siguientes cargos:

Cargos por solicitud

Cada operación genera una solicitud GetObject, lo que implica un cargo por solicitud. Request fees.
Cargos por tráfico

Los cargos por tráfico de salida se basan en el tamaño de la imagen procesada. Traffic fees.

Versiones de IMG

IMG cuenta con una versión de API nueva y una antigua. Este documento cubre la versión nueva; la versión antigua ya no recibe actualizaciones. New and old versions of IMG and their compatibility.