Images Videos Pricing Docs View as Markdown (Agent) Get started
Human Agent

An image CDN API
you drive with the URL.

Upload once. Every image gets a global CDN URL, and a query string resizes, crops and converts it on the fly. No transform API, no copy per breakpoint.

Transforms are query params

The edge generates the variant on the first request and caches it, so later requests are served from cache. The same image URL works in an <img>, a CSS background, an email or an OG tag.

# Original
https://img.pixelvault.dev/proj_abc/img_xyz.jpg

# 400px wide, cropped to fill, served as WebP
https://img.pixelvault.dev/proj_abc/img_xyz.jpg?w=400&fit=cover&fmt=webp

# Let the edge pick WebP or AVIF from the browser's Accept header
https://img.pixelvault.dev/proj_abc/img_xyz.jpg?w=800&fmt=auto

# 1200×630 Open Graph card, one param
https://img.pixelvault.dev/proj_abc/img_xyz.jpg?size=social

What the CDN does for you

The parts of an image pipeline you would otherwise build and run yourself.

Resize and crop

w, h and fit cover the common cases, and gravity=face crops toward a detected face for avatars.

Modern formats

fmt=auto serves WebP or AVIF to browsers that accept them and falls back for the rest.

Background removal

segment=foreground returns a transparent cut-out, with an optional solid background fill.

Cached at the edge

Variants are cached across Cloudflare's network, so the origin is only hit on a cache miss.

No egress fees on storage

Originals live in Cloudflare R2, which doesn't charge for egress. Plans still carry a bandwidth allowance; the free tier includes 1 GB.

Safe by default

An invalid param is ignored, never an error page. Transforms apply to public raster images; private images and SVGs are served as-is.

The main parameters

The complete list, with every accepted value and edge case, is in the transforms docs.

ParamValuesNotes
w, hpixelsWidth and height. Snapped up to a discrete set (16–4000) so results cache well.
fitscale-down · contain · cover · crop · padDefault scale-down never enlarges a small source.
fmtwebp · avif · jpg · png · autoauto negotiates WebP or AVIF from the Accept header.
qauto · 60 · 75 · 85Output quality. Default auto.
sizes · m · l · social · square · portraitNamed presets, including a 1200×630 social card.
gravityauto · face · left · right · top · bottomWhere to crop toward with fit=cover or crop.
segmentforegroundRemoves the background and returns a transparent image.
blur, sharpen, rotate, flip, brightness, contrast, saturationsee docsEffects that stack with resize and crop.

Where the URL comes from

Every image you upload through the image upload API returns a CDN URL; for public raster images it looks like https://img.pixelvault.dev/proj_abc/img_xyz.jpg. Add params to that URL and nothing else changes. For the overview, see the image hosting API; for building on S3 yourself, the S3 and CloudFront comparison; and for a managed alternative, the best Cloudinary alternatives.

Image CDN API FAQ

What is an image CDN API?

An image CDN API gives every uploaded image a globally cached URL and lets you request a different size, crop or format by changing that URL, so you don't run your own resize pipeline or store a copy per breakpoint.

How do I resize an image with PixelVault?

Append query params to the image's CDN URL, for example ?w=400&fit=cover&fmt=webp. The edge resizes and converts it on the first request, then caches the result. There is no separate transform API call.

Can it serve WebP and AVIF automatically?

Yes. Use fmt=auto and the edge picks WebP or AVIF from the browser's Accept header. Pass an explicit fmt when the consumer needs a specific type, such as an email client.

What happens with an invalid parameter?

Invalid params are ignored and never produce an error page. Valid params still apply, and if none are valid you get the original image. Private images (signed URLs) and SVGs are not transformed; they are served as-is.

Does the CDN charge for bandwidth?

Storage is on Cloudflare R2, which has no egress fees, and delivery is through Cloudflare's network. Plans still include a monthly bandwidth allowance (1 GB on the free tier); see the pricing page for the paid tiers.

Do transforms cost extra?

Transforms are available on all plans and need no extra call. On the free tier they have a monthly budget; once a project passes it, requests get the original image instead of a transformed one. Paid plans aren't capped this way.

Try a transform on your own image

Free tier: 200 MB storage, 500 uploads/month, no credit card. See pricing for paid plans.

Get your API key