Public docs, plans, and endpoint reference.
Public ยท No admin requiredhttps://photon.lafu.fi| Tier | Plan label | Rate limit | Monthly included usage | Max upload / request | Best for |
|---|---|---|---|---|---|
| Free | Free | 10/min | 1 GB | 5 MB | Tryout and side projects |
| Pro | Pro | 50/min | 10 GB | 15 MB | Production personal apps |
| Business | Business | 100/min | 50 GB | 50 MB | Teams and higher throughput |
| Enterprise | Enterprise | 200/min | Unlimited | Unlimited | High-scale usage |
| Method | Path | Auth | Notes |
|---|---|---|---|
GET | /health | None | Service health check. |
GET | /ready | None | Readiness for storage and Redis dependencies. |
POST | /optimize | Bearer API key | Upload image and receive optimized output URLs. |
GET | /status/:id | Bearer API key | Check async job status when queue mode is used. |
GET | /quota | Bearer API key | Current API key usage/quota. |
GET | /api/quota | Bearer API key | Alias for /quota. |
POST | /demo/api/optimize | None | Public demo endpoint (server-managed defaults/rate limits). |
curl -sS -X POST "https://photon.lafu.fi/optimize" -H "Authorization: Bearer YOUR_API_KEY" -F "file=@./photo.jpg" -F "format=auto" -F "quality=80"Supported fields include format, quality, width, height, webp_effort, avif_effort, and jpeg_chroma.