> For the complete documentation index, see [llms.txt](https://docs.omnidata.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnidata.xyz/gateway/imghub-apis.md).

# Imghub APIs

With the web3 apps growing, more and more dApps are needing to retrieve images from decentralized storage networks like IPFS and Filecoin. Based on the research, we have found that most dApps do not require showing the original photos but only show thumbnails, avatars, or compressed and resized images, for example, the NFT marketplaces, the crypto games, the Metaverse, and the dApps, etc. As you may know, if you use an IPFS CID ([content identifier](https://docs.ipfs.io/concepts/content-addressing/)) to fetch the image, it will return the original size. Unfortunately, there is no straightforward and native approach to automatically make images from decentralized storage networks fit into the responsive UI.

The Imghub (former Img8 protocol) provides a gateway with native image processing and optimization protocol for IPFS and Filecoin to web3 developers, designers, and creators. They can specify what they need in the query parameters of the gateway access URL like `https://gateway.omnidata.xyz/ipfs/CID?w=200` and it will return the compressed and resized image with a width of 200px. It's easy peasy.

## Original image

Get the original image by using the IPFS CID:

{% content-ref url="/pages/10K40y0VoejgikhHov6u" %}
[Original image from IPFS](/gateway/imghub-apis/original-image-from-ipfs.md)
{% endcontent-ref %}

## Resize image

Get resized image by using the IPFS CID:

{% content-ref url="/pages/mPkaploA9OxaXQWdSQjT" %}
[Resize image](/gateway/imghub-apis/resize-image.md)
{% endcontent-ref %}

## Avatar

Generate a circled avatar image:

{% content-ref url="/pages/2sBxxmvnaiwSESvALAov" %}
[Avatar](/gateway/imghub-apis/avatar.md)
{% endcontent-ref %}

## Composite image

Compositing a new image over the processed image:

{% content-ref url="/pages/whyzIzEYmcG2w5PjW4ag" %}
[Composite image](/gateway/imghub-apis/composite-image.md)
{% endcontent-ref %}

## Rotate image

{% content-ref url="/pages/fbjaSdgtlIt6wdoC4aml" %}
[Rotate image](/gateway/imghub-apis/rotate-image.md)
{% endcontent-ref %}

## Flip image

{% content-ref url="/pages/jfhKBdO2pWgoDagO2ZIC" %}
[Flip image](/gateway/imghub-apis/flip-image.md)
{% endcontent-ref %}

## Flop image

{% content-ref url="/pages/xn4jOVAoLgHiIbNvQ2tq" %}
[Flop image](/gateway/imghub-apis/flop-image.md)
{% endcontent-ref %}

## Blur image

{% content-ref url="/pages/3YpHoM9tnpMJYBhTRJet" %}
[Blur image](/gateway/imghub-apis/blur-image.md)
{% endcontent-ref %}