Domainless Image API

Upload, transform, and deliver images via URL. Resize, crop, format convert, blur, grayscale — all cached and CDN-ready.

https://api.img.domainless.fun

URL-Based Transforms

Cloudinary-style URLs

Transform images by URL — no API call needed:

/img/{image_id}/w_400,h_300,f_webp,q_80

Transforms are cached on first request. Subsequent requests serve from cache.

Transform Parameters

Param	Description	Example
`w`	Width (px)	`w_400`
`h`	Height (px)	`h_300`
`f`	Format (jpeg, png, webp, avif)	`f_webp`
`q`	Quality (1-100)	`q_80`
`fit`	Resize mode (cover, contain, fill)	`fit_contain`
`blur`	Gaussian blur sigma	`blur_5`
`grayscale`	Convert to grayscale	`grayscale_1`
`rotate`	Rotation degrees	`rotate_90`
`flip`	Flip vertical	`flip_1`
`flop`	Flip horizontal	`flop_1`
`sharpen`	Sharpen	`sharpen_1`

API Endpoints

POST /api/v1/upload API Key / JWT

Upload an image. Returns metadata + public URL.

Request

Content-Type: multipart/form-data
X-API-Key: dli_your_key

file: (binary image)

Response

{
  "image": {
    "id": "a1b2c3...",
    "width": 1920,
    "height": 1080,
    "mime_type": "image/png",
    "url": "https://api.img.domainless.fun/img/a1b2c3..."
  }
}

GET /api/v1/images API Key

List uploaded images. Paginated.

?page=0&limit=20

{ "images": [...], "total": 42 }

GET /api/v1/images/:id API Key / JWT

Get image metadata.

GET /api/v1/images/:id/transform Public

Transform via query params instead of URL path.

/api/v1/images/{id}/transform?w=400&h=300&f=webp&q=80

DELETE /api/v1/images/:id API Key

Delete image and all cached transforms.