HEADLESS RENDERER / V1

Pixels on demand.

One endpoint turns text and the same options as the studio into editable SVG or production-ready PNG.

GET · POST/api/v1/render

Cacheable SVG URL

Use GET when parameters fit in a URL. Responses are deterministic, cached, and carry an ETag.

curl --get 'https://pxface.com/api/v1/render' \
  --data-urlencode 'text=HELLO
THERE' \
  --data 'format=svg' \
  --data 'ratio=fit' \
  --output hello-there.svg

PNG from JSON

Use POST for structured agent calls. PNG and SVG come from the exact same render scene.

curl 'https://pxface.com/api/v1/render' \
  --header 'Content-Type: application/json' \
  --data '{"format":"png","options":{"text":"HELLO\nTHERE","ratio":"square","colorMode":"random","seed":42}}' \
  --output hello-there.png

Everything the studio knows.

text, three colors, letter/word/line spacing, pixel gap, depth, padding, fit or square ratio, alignment, shape, slant, transparency, solid/random color mode, seed, and output scale.

Built for automation.

Errors include field-level issues. Output dimensions and renderer version are exposed as headers. Public CORS is enabled; the current limit is 60 requests per minute per IP. Text is capped at 160 characters and 8 lines.