API Documentation

📐 Size

Syntax: width x height. Omit height for a square. Min: 10×10, Max: 4000×4000.

🧩 Format

Put the format at the end (/png or .png). Default: SVG.
Supported: SVG, PNG, JPEG, GIF, WebP, AVIF.

🎨 Colour

Use HEX (3–8 chars) or CSS names. The transparent keyword makes a transparent background. When specifying colors, pass both bg/fg.

📝 Text

Use query ?text=.... Space +, new line \\n. Default text is the image size (e.g. 600 × 400).

🔤 Fonts

?font=FontName. Default: Lato.
For bitmap outputs (PNG/JPEG/WebP/AVIF/GIF), prefer TTF/OTF/TTC files in /storage/fonts.
List fonts: https://phldr.com/api/fonts.

🔷 Retina

Append @2x or @3x after the size.
Applies to: PNG, JPEG, GIF, WebP, AVIF (SVG ignores DPR).

⚙️ Advanced