Documentation

Basic Usage

Create a proxy in the Dashboard, keep the image path, and request it from the new hostname.

Dashboard is at https://dashboard.webp.se/login, we support login with GitHub only.

Once you've logged in with GitHub, you can create your first Proxy.

Create Proxy form in the Dashboard

For example, if your image is at https://webp.se/images/public-services/webp-wordpress.png, then you should fillin https://webp.se in Proxy Origin URL field.

After creation, you'll find a new address, in the example below, it's https://559a238.webp.ee.

Proxy details showing the generated webp.ee address

Now you can make request to https://559a238.webp.ee/images/webp-wordpress.png for a WebP optimized image.

GEThttps://559a238.webp.ee/images/webp-wordpress.png
Status
200
Version
HTTP/2
Transferred
76.24 kB (75.42 kB size)

Response headers

accept-ranges
bytes
access-control-allow-origin
*
content-length
75422
content-type
image/avif
etag
W/"162561-1EA12D1D"
x-compression-rate
0.46
X-Firefox-Spdy
h2
x-powered-by
WebP Cloud Services (NUE)
x-webpcloud-cache
Hit
x-webpcloud-cost
0
x-webpcloud-fetch-cost
0

In order to change all your images url on website to new address, please refer to Access page.

Proxy Mode

⚡ Rapid Mode

On the first request, WebP Cloud will convert and optimize the image before returning it.

RapidThe visitor waits until the optimized image is ready.

First request: WebP Cloud fetches the origin, converts it, then returns the optimized image.

Visitor
https://xxx.webp.ee/path/to/image.jpgimage/webp · Wait, then optimized
WebP Cloud
https://some.origin.tld/path/to/image.jpgimage/jpeg · Fetch and convert
Origin

Later requests are served from cache. The origin is not contacted.

Visitor
https://xxx.webp.ee/path/to/image.jpgimage/webp · Render through cache
WebP Cloud
Origin
  • Best for API-style use cases.
  • Guarantees users always get optimized images.
  • This is the current behavior for all existing proxies.

🔄 Consistency Mode

On the first request, WebP Cloud will return the origin image immediately (after lightweight processing like EXIF removal or cropping), while the full optimization happens asynchronously in the background.

ConsistencyThe first response returns immediately. Optimization finishes in the background.

First request: the visitor receives the origin image right away, while WebP Cloud keeps optimizing it.

Visitor
https://xxx.webp.ee/path/to/image.jpgimage/jpeg · Return immediately
WebP Cloud
https://some.origin.tld/path/to/image.jpgimage/jpeg · Optimize in background
Origin

A later request hits the cache and returns the optimized image.

Visitor
https://xxx.webp.ee/path/to/image.jpgimage/webp · Optimized from cache
WebP Cloud
Origin
  • Best for high-concurrency, large-scale traffic scenarios.
  • Ensures instant responsiveness on first access.
  • Subsequent requests will hit the cache and return the optimized version.
FeatureRapidConsistency
First requestWaits for conversion, then returns optimized imageReturns origin immediately (lightly processed), optimizes in background
ExperienceAlways optimized, slightly slower on first accessInstant first access, optimized on later requests
Best forAPI usage, strict quality requirementsHigh concurrency, large-scale traffic
Core valueQuality-firstSpeed-first + Eventual consistency

Refer to WebP Cloud Introduces Mode Selection — Rapid (Instant Optimization) and Consistency (Eventual Optimization Mode) for more details.

Live Demo

Original Image

Original WordPress screenshothttps://webp.se/images/public-services/webp-wordpress.png

With WebP Cloud

WordPress screenshot optimized by WebP Cloudhttps://559a238.webp.ee/images/webp-wordpress.png

With WebP Cloud and ?width=100

WordPress screenshot resized to 100 pixels widehttps://559a238.webp.ee/images/webp-wordpress.png?width=100

Custom Domain

https://559a238.webp.ee/ is tooooo long for you, and you want to use your domain like https://webp.your-domain.tld?

No problem! We support custom domain as a paid plan, see Custom Domain for more info.