API Documentation

Generate OG images programmatically. One POST request, instant CDN URL.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer aog_live_xxxxxxxxxxxx

Get your API key from the Dashboard. Pro plan required for production keys.

Quick Start

curljavascriptpython

curl -X POST https://autoog.com/api/v1/generate \
  -H "Authorization: Bearer aog_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "How to Build a SaaS in 30 Days",
    "description": "A step-by-step guide for indie hackers",
    "template": "blog",
    "theme": "dark"
  }'

Endpoints

POST/api/v1/generateGenerate a single OG image

Parameter	Type	Required	Description
title	string	required	Page title (max 80 chars)
description	string	optional	Page description (max 160 chars)
template	string	optional	default \| blog \| product \| minimal
theme	string	optional	dark \| light (default: dark)
format	string	optional	url \| base64 (default: url)

POST/api/v1/batchGenerate multiple OG images (max 50)

Parameter	Type	Required	Description
items	array	required	Array of {title, description} objects
template	string	optional	Template for all items
theme	string	optional	Theme for all items

GET/api/v1/templatesList available templates

GET/api/v1/usageGet current usage stats

Rate Limits

Plan	Monthly	Per Minute	Batch Max
Free	No API access	—	—
Pro ⚡	Unlimited	120 req/min	50 images

Ready to integrate?

Get your API key and start generating OG images in minutes.

Get API Key →