---
title: "Serve or transform an image"
method: GET
path: "/{project_id}/{filename}"
tags: ["Image Delivery"]
---

# Serve or transform an image

`GET /{project_id}/{filename}`

## Request

- Base URL: `https://img.pixelvault.dev`
- URL: `https://img.pixelvault.dev/{project_id}/{filename}`
- Auth: none declared

Fetch an image from the CDN — optionally transformed on the fly via query params — from img.pixelvault.dev (not the API host). No API call or auth for public images. Transforms are edge-cached; invalid params are ignored (the original is returned, never an error); SVG sources are served as-is (not transformed). `filename` is `{image_id}.{ext}` and may be preceded by a folder path (e.g. `blog/img_abc123.png`). The effect params (segment, gravity, zoom, blur, sharpen, rotate, flip, brightness, contrast, saturation) apply to your project images, not the anonymous playground. Response headers: `X-PV-Transform` echoes the applied operations; `X-PV-Cache` is HIT|MISS.

## Path parameters

- `project_id` string, required
- `filename` string, required

## Query parameters

- `size` 's' | 'm' | 'l' | 'social'
- `w` integer
- `h` integer
- `fit` 'scale-down' | 'contain' | 'cover' | 'crop' | 'pad'
- `fmt` 'auto' | 'webp' | 'avif' | 'jpg' | 'png'
- `q` 'auto' | '60' | '75' | '85'
- `segment` 'foreground'
- `background` string
- `gravity` string
- `zoom` number
- `blur` integer
- `sharpen` number
- `rotate` 90 | 180 | 270
- `flip` 'h' | 'v' | 'hv'
- `brightness` number
- `contrast` number
- `saturation` number
- `tile` string
- `token` string
- `expires` integer

## Response `200`

The image, transformed if params were supplied.

## Other responses

- `403`: Signed URL invalid or expired, or a signed transform could not be served.
- `404`: Image or project not found.
- `410`: Image expired or deleted (a placeholder image is returned).
- `429`: Bandwidth limit exceeded on the free tier (a placeholder image is returned).

---

[API](https://skmtc.dev/pixelvault/apis/pixelvault-api.md) · [All operations](https://skmtc.dev/pixelvault/apis/pixelvault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pixelvault/apis/pixelvault-api/revisions/6332d8c3f8e0?raw)