Docs

API reference

Base URL: https://ogstamp.com

Authentication

Send your key as Authorization: Bearer ogs_… or X-Api-Key.

Generate image

GET|POST /api/og → image/png

curl -X POST https://ogstamp.com/api/og \
  -H "Authorization: Bearer ogs_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"Launch day","subtitle":"We shipped","theme":"coral","badge":"Changelog"}' \
  -o card.png

Fields: title (required), subtitle, badge, theme (midnight, paper, forest, coral, slate).

Successful API responses include X-Credits-Remaining.

Check balance

curl https://ogstamp.com/api/credits \
  -H "Authorization: Bearer ogs_…"

Free tier

Without a key: 30 renders / IP / rolling 24 hours (for the browser generator and experiments).

Top up an existing key

After a new PayPal purchase completes, attach credits to a key you already have:

curl -X POST https://ogstamp.com/api/topup \
  -H "Content-Type: application/json" \
  -d '{"api_key":"ogs_…","order_id":"<local order uuid>"}'

The order must be paid and not already attached to another key.

Errors

Buy credits