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 |
|
resize |
Redimensionne l'image aux dimensions spécifiées. |
|
|
watermark |
Ajoute un filigrane (image ou texte) à l'image. |
|
|
crop |
Recadre l'image dans un rectangle de taille spécifiée. |
|
|
quality |
Ajuste la qualité des images JPG et WebP. |
|
|
format |
Convertit le format de l'image. |
|
|
format |
Convertit l'image vers un format à haute compression, tel que HEIF ou AVIF. |
|
|
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). |
|
|
auto-orient |
Fait pivoter automatiquement l'image en fonction de ses métadonnées d'orientation. |
|
|
circle |
Recadre une image circulaire de taille spécifiée, centrée sur l'image d'origine. |
|
|
indexcrop |
Découpe l'image en sections le long de l'axe x ou y et sélectionne l'une des sections. |
|
|
rounded-corners |
Recadre l'image dans un rectangle aux coins arrondis d'un rayon spécifié. |
|
|
blur |
Applique un effet de flou à l'image. |
|
|
rotate |
Fait pivoter l'image dans le sens horaire selon un angle spécifié. |
|
|
interlace |
Active le rendu progressif pour une image au format JPG. |
|
|
average-hue |
Récupère la teinte moyenne de l'image. |
|
|
bright |
Ajuste la luminosité de l'image. |
|
|
sharpen |
Applique un effet de netteté à l'image. |
|
|
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 |
|
|
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 |
|
Dimensions de l'image cible |
|
|
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 |
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é.