Documentation

Help & Knowledgebase

APIs

A question about Cloudimage? This is where you will most likely find your answer.

General Questions

Cloudimage was created in France but our teams sit in London, Paris, Munich, Sofia and Seoul. The service is available world wide with 24/7 support from Europe and Asia. We use global Content Delivery Networks with over 200 datacenters, have a look at the datacenter map.
Your Token identifies you as a Cloudimage user and is part of any image URL transformed by Cloudimage. It is clearly displayed in your admin portal after you log in.
The plan allowances are soft limits, so you can use up to 110% of your plan's allowance without any trouble from us. You can either upgrade to the next plan from your admin portal or contact us to discuss a CUSTOM plan.
The supported formats are: .jpg, .png, .gif. We are also able to generate images in webp to further optimize the loading times on certain browsers.
Yes you can, your token is independent of your website so you can use it for several website. We can also create multiple tokens for your account if you want to resell Cloudimage to your customers.
Absolutely! By default, Cloudimage is not meant to store your images forever and your image cache might get flushed in case your images do not get requested frequently enough. We also offer our own storage solution in the Cloud: Airstore. Feel free to contact us at hello@cloudimage.io for more info.
Absolutely! You can use only the image optimization / transformation part of Cloudimage and link your current CDN to us. Feel free to contact us at hello@cloudimage.io and an engineer from our team will help you to setting it up (for free!).
It is not possible to change your token, however you can create a CNAME entry to create a custom token. We also support HTTPS on custom domains, please contact us at hello@cloudimage.io and an engineer will help to setting it up (yes, for free again!).
We use both CDNetworks and Amazon Cloudfront as CDN providers with over 200 PoPs world wide. Check out our PoP map.

Image transformation and processing

Cloudimage supports following transformations: width, height, crop, fit, bound and cover. And many more. The full documentation is available here.
As per Cloudimage's architecture, your image is first downloaded from your origin storage over HTTP(s), cached, transformed and spread out to all CDN Points of Presence (PoPs). Once cached in the CDN, the image is delivered at lightspeed for every subsequent request.
There is no limit on the origin image size, however there is a default download timeout of 10 seconds. Hence, Cloudimage will not process your image if takes more than 10 seconds to download from your origin storage. The timeout value is configurable, let us know if you need it to be increased by dropping us an email at hello@cloudimage.io.
Once your images are downloaded from our resizing infrastructure, they are processed and cached on SSD storage. This storage is non persitant, therefore Cloudimage requires you to keep a copy of the origin image available via HTTP(s). Contact us if you need persistent storage, we have a solution for that too :): AirStore.
Yes Cloudimage supports automatic watermarking. Checkout the awesome documentation.

Billing

No worries, we won't stop delivering your images. You can either upgrade to the next available plan by logging in to your admin portal or contact us to agree upon a CUSTOM plan. We are cool.
Your traffic and storage statistics are displayed in your admin portal, under the tab 'Token'.
The easiest way to subscribe to a paid plan is to select a plan from your admin portal and enter your credit card details under the 'Billing' tab. You will be invoiced and automatically billed on the 1st of every month. You can also select to be billed annually and benefit from a discount. Finally, you can also pay via bank transfer, please contact us.
Invoices are available within your admin portal, under the tab 'Billing'.

CDN and caching

There are multiple ways to flush / replace an image.
Cloudimage logs every single transformation and CDN caching operation. You can access the logs for your Token within your admin portal, under the 'Last logs' tab.