API Documentation

Create beautiful social preview images for any page. Light and dark themes. Simple REST endpoint.

Authentication

Include your API key in the X-Api-Key header.

X-Api-Key: sk_live_your_api_key

Endpoint

POST https://og.kolni.dev/api/generate

Request Body

Field	Type	Required	Description
`title`	string	Yes	Headline text

Examples

curl
JavaScript
Python
curl -X POST https://og.kolni.dev/api/generate \
  -H "X-Api-Key: sk_live_your_key" \
  -d '{"title":"My Post"}'
const res = await fetch("https://og.kolni.dev/api/generate", {
  method: "POST",
  headers: {"X-Api-Key":"sk_live_your_key","Content-Type":"application/json"},
  body: JSON.stringify({title:"My Post"})
});
import requests
res = requests.post("https://og.kolni.dev/api/generate",
  headers={"X-Api-Key":"sk_live_your_key"},
  json={"title":"My Post"})

Response

Returns SVG image (1200x630).

Header	Value
`Cache-Control`	public, max-age=3600
`X-RateLimit-Remaining`	Requests remaining this minute

Pricing

Free

200 req/mo

$9/mo

3,000 req/mo

$29/mo

30,000 req/mo