# 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.

**Simple override**

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

**Multiple overrides**

```bash
# 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"}}
```

**HTML meta tag**

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

> **Note: 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.

> **Info: PNG only**
>
> The public `/api/render` endpoint always returns PNG. Use `/api/generate` with a `format` field for JPEG, WebP, or PDF output.