Skip to content
Keenpix docs
Getting started

Cloud quickstart

From signup to your first optimized image on managed cloud — no server required.

Prefer not to run your own instance? The managed cloud at keenpix.com is the same engine, hosted — this page gets you from signup to an optimized image in a few minutes. Self-hosting instead? See the Quickstart.

1. Sign up and start your trial

Create an account at keenpix.com. Every plan starts with a 14-day free trial — a card is required, but trial usage is never billed. During the trial you get the plan's full features with up to 2 projects and 20 GB delivered.

2. Create a project

From the dashboard, create a project and enter the hostname your images live on (e.g. cdn.example.com or your S3/R2 bucket host). That origin hostname is automatically added to the project's allowlist, so your first transform works right away — no API key, no extra security step.

Find your project id

It's under Settings → General → Project ID. Managed delivery puts it in the canonical path: https://cdn.keenpix.com/p/YOUR_ID.

3. Copy the transform URL

A request is just a URL — prefix your image with the cloud endpoint:

<img
  src="https://cdn.keenpix.com/p/YOUR_ID/img/https%3A%2F%2Fcdn.example.com%2Fhero.jpg?w=800&fmt=webp"
  sizes="100vw"
  loading="lazy"
  decoding="async"
  alt="Hero"
/>

Encode the complete source URL with encodeURIComponent(source) before appending it after /img/. This preserves https://, query parameters, and fragments as one source value. Managed delivery is available only through the canonical CDN hostname.

Use fmt=auto to negotiate AVIF/WebP/JPEG from each browser's Accept header instead of pinning a format. The first request is a cache MISS (Keenpix fetches + transforms the original); every later request for the same parameters is a HIT.

4. Point your site at it

Swap your image URLs — or your framework's image loader — to the transform endpoint. Most codebases build image URLs in one place, so this is typically a single-file change. See the framework guides for Next.js, Nuxt, TanStack Start, SvelteKit, Astro, and more.

5. Watch the savings

Open Analytics to see bandwidth saved, cache hit rate, format mix, and live request logs — included on every plan. Billing counts optimized bytes delivered through the managed Keenpix network. A Cloudflare edge hit, a Keenpix cache hit, and a newly optimized response each count once; transformations and team members are unlimited. Browser or customer-owned CDN cache hits that never reach Keenpix are not counted. Bandwidth saved is a separate analytics comparison and is never added to billable delivered bytes.

See the API reference for the full parameter list, or Projects & access for how allowlists gate requests.

On this page