> For the complete documentation index, see [llms.txt](https://docs.spectrumcustomizer.com/integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spectrumcustomizer.com/integration/api/image-querystring-api.md).

# Image QueryString API

The commands available are documented into the following categories:

* [Image Transforms](/integration/api/image-querystring-api/image-transforms.md)
* [Image Filters](/integration/api/image-querystring-api/image-filters.md)
* [Image Encoding](/integration/api/image-querystring-api/image-encoding.md)

## Usage

```
/api/assets/generated/recipeSet/readable/L83NJTB7/east?width=400&height=400
```

{: .note }

> Note: the order of QueryString parameters does not affect output. The are evaluated in the most efficient operations regardless of order.

## Examples

\
​[https://api.spectrumcustomizer.com/api/assets/generated/recipeSet/readable/L83NJTB7/east?**width=250\&height=250**](https://api.spectrumcustomizer.com/api/assets/generated/recipeSet/readable/L83NJTB7/east?width=150\&height=150\&bgcolor=CCCCCC)

<div align="left"><img src="/files/-MSBgvZeFkIjleJ6LLUP" alt="?width=250&#x26;height=250"></div>

[https://api.spectrumcustomizer.com/api/assets/generated/recipeSet/readable/L83NJTB7/east?**width=150\&height=150\&bgcolor=CCCCCC**](https://api.spectrumcustomizer.com/api/assets/generated/recipeSet/readable/L83NJTB7/east?width=150\&height=150\&bgcolor=CCCCCC)

<div align="left"><img src="/files/-MSBjmR4HWvNzwSGJElc" alt="?width=150&#x26;height=150&#x26;bgcolor=CCCCCC"></div>

### Other Examples

* `width=100&height=100&mode=max&scale=down` ensures the image is downscaled to 100x100 or less, but does not upscale the image if it is already smaller than that. Aspect ratio is maintained.
* `width=200&height=200&mode=max&scale=both` ensures the image is downscaled or upscaled to fit within 200x200, maintaining aspect ratio.
* `width=200&height=200&mode=pad&scale=both` ensures the image is downscaled or upscaled to fit within 200x200, maintaining aspect ratio, then is padded to make the result always 200x200.
* `width=300&height=300&mode=crop&scale=both` ensures the image is downscaled or upscaled to fit around 300x300, then minimally cropped to meet the aspect ratio. `scale=both` ensures the image is upscaled if smaller so the result is always 300x300.