Tous les produits
Search
Centre de documentation

Object Storage Service:Image processing (IMG)

Dernière mise à jour :Aug 18, 2026

Ajoutez des paramètres IMG aux requêtes GetObject pour traiter les images stockées dans OSS. Redimensionnez, recadrez, ajoutez un filigrane, convertissez les formats, etc.

Paramètres IMG

Traitez les images avec un ou plusieurs paramètres, ou regroupez-les dans un style pour un traitement par lot. Styles d'image.

Si vous spécifiez plusieurs paramètres IMG, OSS traite l'image dans l'ordre indiqué.

Actions

Paramètre

Description

Redimensionnement d'image

resize

Redimensionne l'image aux dimensions spécifiées.

Filigrane

watermark

Ajoute un filigrane (image ou texte) à l'image.

Recadrage personnalisé

crop

Recadre l'image dans un rectangle de taille spécifiée.

Ajustement de la qualité

quality

Ajuste la qualité des images JPG et WebP.

Conversion de format

format

Convertit le format de l'image.

Compression avancée pour les images HEIF ou AVIF

format

Convertit l'image vers un format à haute compression, tel que HEIF ou AVIF.

Interrogation des informations sur l'image

info

Récupère les informations de l'image, telles que les propriétés de base et les données EXIF (Exchangeable Image File Format).

Orientation automatique

auto-orient

Fait pivoter automatiquement l'image en fonction de ses métadonnées d'orientation.

Recadrage circulaire

circle

Recadre une image circulaire de taille spécifiée, centrée sur l'image d'origine.

Découpage indexé

indexcrop

Découpe l'image en sections le long de l'axe x ou y et sélectionne l'une des sections.

Rectangle arrondi

rounded-corners

Recadre l'image dans un rectangle aux coins arrondis d'un rayon spécifié.

Flou

blur

Applique un effet de flou à l'image.

Rotation

rotate

Fait pivoter l'image dans le sens horaire selon un angle spécifié.

Définir le mode d'affichage

interlace

Active le rendu progressif pour une image au format JPG.

Obtenir la teinte moyenne

average-hue

Récupère la teinte moyenne de l'image.

Luminosité

bright

Ajuste la luminosité de l'image.

Netteté

sharpen

Applique un effet de netteté à l'image.

Contraste

contrast

Ajuste le contraste de l'image.

Par exemple, l'ajout des paramètres resize et quality à example.jpg génère l'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. Configurez CDN pour récupérer l'image source ou l'image traitée lors des requêtes de retour à l'origine.

  • Retour à l'origine pour l'image source

    Avec le filtrage des paramètres activé, CDN supprime tous les paramètres après le point d'interrogation (?) et récupère l'image source example.jpg.

  • Retour à l'origine pour l'image traitée

    Avec la conservation des paramètres, CDN conserve les paramètres de l'URL et récupère l'image traitée.

Configurez les règles de retour à l'origine de CDN avec Ignorer les paramètres.

Méthodes IMG

Traitez les images à l'aide d'URL d'objet, d'opérations API ou de SDK. Méthodes de traitement d'image.

Limites

Élément

Description

Formats d'image

  • L'image source doit être dans l'un des formats suivants : JPG, PNG, BMP, GIF, WebP, TIFF, HEIC ou AVIF.

  • Pour les images dynamiques telles que les GIF animés, seuls le redimensionnement, le recadrage, la rotation et l'ajout de filigrane sont pris en charge.

  • Pour encoder ou décoder des images WebP animées, soumettez un ticket.

Taille de l'image

Taille maximale de l'image source : 20 Mo.

Dimensions de l'image source

Rotation : la largeur ou la hauteur maximale est de 4 096 px. Autres opérations : la largeur ou la hauteur maximale est de 30 000 px, avec une limite totale de 250 millions de pixels.

Le nombre total de pixels pour les images dynamiques, telles que les images GIF, est largeur hauteur nombre d'images, tandis que pour les images statiques, telles que les images PNG, il est largeur * hauteur.

Dimensions de l'image cible

  • Pour les images WebP, la largeur et la hauteur ne peuvent pas dépasser 16 383 px.

  • Pour les images HEIC, la largeur et la hauteur ne peuvent pas dépasser 4 096 px.

  • Pour les images AVIF, la largeur ne peut pas dépasser 4 096 px et le nombre total de pixels ne peut pas dépasser 9 437 184.

Redimensionnement d'image

Après le redimensionnement, la largeur ou la hauteur ne peut pas dépasser 16 384 px et le nombre total de pixels ne peut pas dépasser 16 777 216.

Styles d'image

Maximum : 50 styles d'image par bucket. Pour en demander davantage, soumettez un ticket.

Remarque

Un seul style d'image peut inclure plusieurs paramètres IMG pour des opérations complexes. Styles d'image.

Capacité de traitement

  • Débit de traitement d'image par seconde (basé sur la taille de l'image source)

    • Chine (Hangzhou), Chine (Shanghai), Chine (Pékin), Chine (Zhangjiakou) et Chine (Shenzhen) : 20 Mo/s.

    • Autres régions : 2 Mo/s.

  • Requêtes par seconde (QPS)

    • Chine (Hangzhou), Chine (Shanghai), Chine (Pékin), Chine (Zhangjiakou) et Chine (Shenzhen) : 50.

    • Autres régions : 5.

Remarque

Pour les scénarios à forte intensité de calcul (encodage WebP, AVIF ou HEIF supérieur à 1080p) ou les charges de travail dépassant ces limites, contactez le support technique pour évaluer les limites adaptées à votre cas d'utilisation.

Facturation

IMG entraîne les frais suivants :

  • Frais de requête

    Chaque opération génère une requête GetObject, entraînant des frais par requête. Frais de requête.

  • Frais de trafic

    Les frais de trafic sortant sont basés sur la taille de l'image traitée. Frais de trafic.

Versions IMG

IMG dispose d'une nouvelle et d'une ancienne version d'API. Cette rubrique couvre la nouvelle version ; l'ancienne version n'est plus mise à jour. Nouvelles et anciennes versions d'IMG et leur compatibilité.