Optimiser la taille des fichiers image
🤖/image/optimize réduit la taille des fichiers image à l’aide d’outils de compression propres à chaque format.

Ce Robot réduit la taille des fichiers d’images JPEG, PNG, GIF, WebP et SVG à l’aide d’outils de compression propres à chaque format. Selon le format et les réglages, l’optimisation peut être sans perte ou avec perte.
Ce Robot vous permet de réduire vos coûts de stockage et de bande passante, et améliore votre expérience utilisateur et votre monétisation en réduisant le temps de chargement des pages web riches en images.
Il fonctionne bien avec 🤖/image/resize pour faire bénéficier votre site web ou votre application de toute la puissance des images redimensionnées et optimisées.
Pour les images JPEG, les réglages par défaut priority: "compression-ratio" et preserve_meta_data: true comparent un résultat sans perte de jpegtran à un résultat avec perte de MozJPEG cjpeg et sélectionnent le plus petit résultat valide. L’encodeur cjpeg utilise sa qualité par défaut de 75 ; le résultat sélectionné peut donc présenter des artéfacts de compression. Cela ne signifie pas que chaque image JPEG est réencodée avec une qualité de 75 : un résultat sans perte peut être retenu à la place.
Pour optimiser les images JPEG sans perte de qualité supplémentaire, utilisez priority: "conversion-speed", qui exécute jpegoptim en mode sans perte. La conversion en JPEG progressif peut elle aussi être sans perte. Par exemple :
{
"steps": {
"optimized": {
"robot": "/image/optimize",
"use": ":original",
"priority": "conversion-speed",
"progressive": true,
"preserve_meta_data": true
}
}
}
Avec ces réglages, jpegoptim peut conserver le JPEG d’origine si le résultat progressif est plus volumineux ; une sortie progressive n’est donc pas garantie. Pour les flux de traitement sensibles aux artéfacts de compression, comme ceux où les images servent d’entrée à la génération de vidéos par IA, utilisez les réglages JPEG sans perte ci-dessus ou conservez les images d’origine.
Ce Robot accepte tous les types d’images et transmet simplement les images de types non pris en charge sans les optimiser, y compris les images JPEG XL (.jxl) lorsqu’aucun résultat optimisé plus petit ne peut être produit. Il n’est donc pas nécessaire de configurer des flux de traitement 🤖/file/filter pour cela.
L’optimisation PNG est sans perte par défaut. Pour activer également la compression avec perte (pngquant), définissez lossy: true et preserve_meta_data: false. pngquant s’exécute alors en premier, et son résultat est utilisé dès qu’il est plus petit que le fichier d’entrée, ce qui peut entraîner des variations de couleur dans certaines images. L’outil d’optimisation sans perte ne s’exécute que lorsque pngquant ne parvient pas à réduire la taille du fichier.
L’optimisation PNG sans perte avec le réglage par défaut priority: "compression-ratio" utilise optipng, dont le traitement peut prendre plusieurs dizaines de secondes pour les grandes images. Définissez priority: "conversion-speed" pour utiliser oxipng à la place. Il utilise plusieurs cœurs de processeur et effectue moins d’essais de compression ; il termine donc généralement plus vite, même si ses fichiers peuvent être légèrement plus volumineux.
Exemple d’utilisation
Optimiser les images téléversées :
{
"steps": {
"optimized": {
"robot": "/image/optimize",
"use": ":original"
}
}
}Paramètres
interpolateboolean | Record<string, boolean>Détermine si les Assembly Variables sont interpolées pour chaque champ d’instruction.
Par défaut, la plupart des champs d’instruction des Robots interpolent les Assembly Variables. Définissez ce paramètre sur
falsepour traiter tous les champs d’instruction comme du texte littéral, ou définissez le chemin d’un champ individuel surfalsepour traiter uniquement ce champ comme du texte littéral. Pour les champs propres à un Robot qui sont littéraux par défaut, définissez ce paramètre surtrueou définissez le chemin de ce champ surtruepour réactiver l’interpolation.Utilisez des noms de champs tels que
path, ou des chemins avec points tels queffmpeg.vfpour les objets imbriqués.output_metaRecord<string, boolean> | boolean | Array<string>Demande des métadonnées coûteuses en CPU, désactivées par défaut pour accélérer les Assemblies.
Pour les images,
"has_transparency": truedétecte la transparence et"dominant_colors": trueextrait les couleurs hexadécimales. Ajoutez"dominant_colors_sampled": truepour obtenir plus rapidement des couleurs approximatives à partir de versions réduites de l’image. L’échantillonnage nécessitedominant_colorset ne modifie ni les octets de l’image ni la facturation. Sa méthode et sa palette peuvent varier. Omettez-le ou désactivez-le pour obtenir des couleurs en pleine résolution.Pour les images, vous pouvez également ajouter
"blurhash": truepour extraire une chaîne BlurHash — une représentation compacte d’un espace réservé pour l’image, utile pour afficher un aperçu flou pendant le chargement de l’image complète.Pour les images,
"thumbhash": trueextrait plutôt un ThumbHash encodé en base64 dansmeta.thumbhash, accompagné demeta.has_alpha(qui indique si un canal alpha existe, même lorsque l’image est entièrement opaque). Il décrit les pixels orientés selon les données EXIF et utilise la première image des images animées. L’extraction est effectuée au mieux : les images de plus de 40 mégapixels, les formats non pris en charge ou un échec de décodage ou un décodage limité ne produisent aucun espace réservé. Une extraction réussie ajoute des frais de métadonnées équivalents à 20 % des octets de ce fichier. Aucun supplément ThumbHash ne s’applique lorsque l’option est désactivée ou lorsqu’aucun hash n’est produit.Définissez cette option sur le Step qui produit l’image, par exemple
/upload/handlepour les originaux téléversés ou/image/resizepour les sorties traitées. La définir uniquement sur/transloadit/storene demande pas l’extraction : le stockage conserve les métadonnées du Step producteur. Transloadit Storage conserve un hash généré avec sa version immuable et le renvoie dans les résultats stockés et lors des lectures natives de ressources. Les téléversements directs vers S3 ne génèrent pas d’espaces réservés. Un espace réservé contient des informations sur l’image : protégez-le donc avec les mêmes contrôles d’accès que l’image complète.Pour les vidéos, vous pouvez ajouter le paramètre
"colorspace": truepour extraire l’espace colorimétrique de la vidéo de sortie.Pour les vidéos, vous pouvez également ajouter
"interlaced": truepour détecter si la vidéo est entrelacée. Cette option combine l’indicateur ffprobe peu coûteuxfield_orderavec une passe d’échantillonnageidetlimitée sur les premières images de la source, et exposeinterlaced,field_orderainsi qu’un objet de diagnosticinterlace_detectionsousfile.meta. Cette opération est coûteuse en calcul et facturée en conséquence.Pour l’audio, vous pouvez ajouter
"mean_volume": truepour obtenir une valeur unique représentant le volume moyen du fichier audio.Vous pouvez également définir cette option sur
falsepour ignorer l’extraction des métadonnées et accélérer le transcodage.user_metaRecord<string, any>(par défaut :{})Ajoute des métadonnées JSON personnalisées à chaque fichier émis sans modifier son contenu. Les objets et tableaux imbriqués sont pris en charge.
L’héritage dépend du Robot. Les valeurs sont fusionnées avec la valeur
user_metaexistante du fichier de sortie ; le Step actuel remplace les clés de premier niveau correspondantes. Attribuez explicitement les clés requises lorsqu’un Robot crée de nouvelles sorties.Dans les Steps de traitement,
${file.*}désigne la première entrée et${result.*}le fichier émis. Les valeurs sont évaluées pour chaque sortie après l’exécution du Robot, avant l’extraction ultérieure des métadonnées et le stockage temporaire. Sur:original, les valeurs sont évaluées pour chaque téléversement avant l’extraction des métadonnées.Les Steps en aval lisent
${file.user_meta.key}. Consultez Métadonnées personnalisées pour un exemple complet et les règles d’héritage.resultboolean(par défaut :false)Indique si les résultats de ce Step doivent figurer dans l’Assembly Status JSON
queuebatchDéfinir la file d’attente sur « batch » abaisse manuellement la priorité des Jobs de ce Step afin d’éviter de consommer des emplacements prioritaires de Jobs pour des Jobs qui n’ont pas besoin d’un temps d’attente nul dans la file
force_acceptboolean(par défaut :false)Forcer un Robot à accepter un type de fichier qu’il aurait ignoré.
Par défaut, les Robots ignorent les fichiers qu’ils ne connaissent pas. Le Robot 🤖/video/encode, par exemple, ignorera volontiers les images en entrée.
Avec le paramètre
force_acceptdéfini surtrue, vous pouvez forcer les Robots à accepter tous les fichiers qui leur sont envoyés. Cela entraîne généralement des erreurs et ne doit être utilisé que pour le débogage ou pour traiter des cas limites.ignore_errorsboolean | Array<meta | execute>(par défaut :[])Ignore les erreurs pendant certaines phases du traitement.
Si vous définissez cette valeur sur
["meta"], le Robot ignorera les erreurs lors de l’extraction des métadonnées.Si vous définissez cette valeur sur
["execute"], le Robot ignorera les erreurs lors de la phase d’exécution principale.Définir cette valeur sur
trueéquivaut à["meta", "execute"]: les erreurs seront alors ignorées dans les deux phases.usestring | Array<string> | Array<object> | objectIndique quel(s) Step(s) utiliser comme entrée.
- Vous pouvez choisir n’importe quel nom pour les Steps, sauf
":original"(réservé aux téléversements des utilisateurs gérés par Transloadit) - Vous pouvez fournir plusieurs Steps en entrée à l’aide de tableaux :
{ "use": [ ":original", "encoded", "resized" ] } - Vous pouvez également étiqueter les Steps d’entrée avec
aspour transmettre une intention sémantique aux Robots :{ "use": [ { "name": ":original", "as": "image" }, { "name": ":original", "as": "mask" } ] }
AstuceC’est probablement tout ce que vous devez savoir sur
use, mais vous pouvez consulter les cas d’utilisation avancés.- Vous pouvez choisir n’importe quel nom pour les Steps, sauf
prioritycompression-ratio | conversion-speed(par défaut :"compression-ratio")Sélectionne les outils d’optimisation JPEG et PNG. La valeur par défaut,
"compression-ratio", privilégie les fichiers plus petits. Pour les JPEG, elle peut utiliser un réencodage avec perte au niveau de qualité 75 lorsquepreserve_meta_data: true, et pour les PNG, elle utilise optipng. Utilisez"conversion-speed"pour optimiser les JPEG sans perte avec jpegoptim et pour optimiser les PNG sans perte plus rapidement avec oxipng. Ce paramètre ne change pas les outils utilisés pour les images GIF, WebP ou SVG.progressiveboolean(par défaut :false)Demande aux outils sélectionnés une sortie progressive ou entrelacée lorsque ce paramètre est défini sur
true. Les navigateurs peuvent alors afficher d’abord une image peu détaillée, puis la préciser à mesure que les données arrivent. Pour les JPEG, la conversion progressive n’exige pas en elle-même de perte de qualité ; le réglageprioritydétermine si un réencodage avec perte est autorisé. Avecpriority: "conversion-speed", jpegoptim peut conserver le JPEG d’origine si la conversion progressive augmente la taille du fichier.preserve_meta_databoolean(par défaut :true)Spécifie si les métadonnées de l’image doivent être conservées ou non pendant l’optimisation. Si elles ne sont pas conservées, la taille du fichier est encore réduite. Sachez toutefois que cela peut supprimer les informations de droit d’auteur d’un photographe, ce qui, pour des raisons évidentes, peut être mal vu.
fix_breaking_imagesboolean(par défaut :true)S’il est défini sur
true, ce paramètre tente de corriger les images qui provoqueraient sinon une erreur de l’outil sous-jacent et feraient ainsi échouer vos Assemblies. Cela peut toutefois parfois augmenter la taille du fichier.lossyboolean(par défaut :false)Lorsque ce paramètre est défini sur
false(valeur par défaut), seuls les outils d’optimisation PNG sans perte sont utilisés, ce qui désactive pngquant afin de préserver la fidélité des couleurs.Lorsque ce paramètre est défini sur
true, pngquant s’exécute en premier, et son résultat est utilisé dès qu’il est plus petit que le fichier d’entrée. L’outil d’optimisation sans perte sélectionné parpriorityne s’exécute que lorsque pngquant ne parvient pas à réduire la taille du fichier. pngquant ne peut pas conserver les métadonnées ; il ne s’exécute donc que lorsquepreserve_meta_datavautfalse. C’est un compresseur avec perte qui réduit les PNG à une palette de 256 couleurs, ce qui peut entraîner des variations de couleur perceptibles dans les images aux palettes de couleurs riches, aux dégradés subtils ou aux couleurs propres à une marque.NoteCe paramètre agit uniquement sur l’optimisation PNG. Définir
lossy: falsene désactive pas le réencodage JPEG avec perte. Utilisezpriority: "conversion-speed"pour optimiser les JPEG sans perte. L’optimisation des GIF, WebP et SVG reste inchangée.
Démonstrations
Articles de blog associés
- Accélérer le Web avec l’optimisation d’images sans perte
- Optimisation PNG améliorée avec l’intégration de Pngquant
- Auto-optimiser les images : réduire coûts et bande passante
- Nouveau modèle tarifaire pour les futurs clients de Transloadit
- Transfert de fichiers efficace et optimisé de Dropbox vers SFTP
- Comment réduire la taille des images sans perte de qualité
- Agrandir et améliorer des images basse résolution en une Assembly