Top
Image API

Format

Last updated: 2026/04/27

Parameters

fm=webp

Converts images to WebP format.

Information: What is WebP?
It is a relatively new image format developed by Google. It is pronounced "weppy."
By simply converting regular jpg or png images to this webp format, the file size can be reduced by about 20% to 30%.

Below is an example of converting the original image in PNG format to WebP format by appending ?fm=webp.

▼URL
https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/0b33104ab3fd2ba2d6b12e8ef25734de/sample-02.png?fm=webp

fm=avif

Converts images to AVIF format.

Information: What is AVIF?
It is a new image format developed by a consortium of companies including Google, Amazon, and Netflix.
It is expected to achieve higher compression rates than the WebP format, but being a newer format, it may not be supported by older versions of browsers.

Below is an example of converting the original image in PNG format to AVIF format by appending ?fm=avif.

▼URL
https://images.microcms-assets.io/assets/d6af1616730544a596d299c20834f460/0b33104ab3fd2ba2d6b12e8ef25734de/sample-02.png?fm=avif

fm=jpg

Converts the image to JPEG format.

fm=png

Converts the image to PNG format.

fm=json

Retrieves the metadata of the image.
Example) ?fm=json

{
  "Content-Type": "image/png",
  "Output": {},
  "ColorModel": "RGB",
  "Content-Length": "104152",
  "Depth": 8,
  "PNG": {
    "InterlaceType": 0,
    "sRGBIntent": 0,
    "Gamma": 0.45455,
    "Chromaticities": [
      0.3127,
      0.329,
      0.64,
      0.33,
      0.3,
      0.6,
      0.15,
      0.06
    ]
  },
  "PixelHeight": 300,
  "PixelWidth": 600,
  "ProfileName": "sRGB IEC61966-2.1"
}

Contents

Parameters
fm=webp
fm=avif
fm=jpg
fm=png
fm=json