Render API · واجهة البرمجة

Status: not enabled. The endpoint is built and tested but switched OFF on this deployment, so it returns 503 today. This page documents it anyway rather than describing something imaginary — write to connect@mashq.ae if you need it turned on.

One endpoint

GET /api/v1/render?text=<utf-8>&size=96
x-api-key: mk_…            (or ?key=mk_…)

→ 200 image/svg+xml       the shaped text as vector outlines
→ 401 missing/malformed key
→ 403 unknown or revoked key
→ 429 this key exceeded its per-minute window
→ 503 the API is not enabled on this deployment

text is required, up to 120 characters. size is the cap height in px (8–400, default 96). The response is a standalone SVG with one <path> per shaped glyph — real Naskh outlines from HarfBuzz, not a font reference, so it renders anywhere without the font installed.

Keys come from a person

There is no self-serve signup. Ask connect@mashq.ae and say what you are building; a key is minted for your project with a rate window that fits it. A key is shown to us once — we store only its hash — so if you lose it we mint a new one rather than recover the old.

What it does not do (yet)

One face: Amiri Naskh. Style selection is not exposed.
No colour, layout, kashida or composition — that is what the studio itself is for.
No SLA. This is a small endpoint on a small business's worker.

Rendering the same text in the full editor: studio.mashq.ae · the engine behind both is documented in the qalam essay.