Documentation

Generate via URL

For public templates, generate images directly via URL with JSON-encoded layer data. No API key, no request body — just a URL you can drop into an og:image tag, an <img> src, or anywhere else that needs a plain image link.

Generate via URL

# Simple text override
/api/render?templateId=uuid&layers={"title":{"text":"Hello World"}}

# Multiple layer overrides
/api/render?templateId=uuid&layers={"title":{"text":"Blog Title"},"subtitle":{"text":"By John Doe"},"logo":{"image_url":"https://example.com/avatar.jpg"}}

<meta property="og:image" content="https://yourdomain.com/api/render?templateId=..." />

Public and unauthenticated

The endpoint doesn't require authentication and doesn't count toward rate limits. Perfect for social media OG images!

Enabling URL access

A cloned or newly created template is private by default. Before /api/render will serve it, enable App → URL Access on the template and either allow all domains or whitelist the domains that are allowed to request it.

PNG only

The public /api/render endpoint always returns PNG. Use /api/generate with a format field for JPEG or WebP output.