Rendra Docs / Overview

Rendra Documentation

AI-powered OG image generation API — generate beautiful Open Graph images programmatically in seconds.

What is Rendra?

Rendra is a REST API that generates Open Graph (OG) images on demand using AI. Point it at your content, provide a prompt, and get back a perfectly sized PNG or JPEG ready to embed in your <meta> tags.

Whether you're generating social cards for a blog, product announcement banners, or dynamic marketing assets, Rendra handles the heavy lifting so you don't have to wrangle image editing tools or Puppeteer instances.

Quick Start — 60 seconds

Get your first image in under a minute.

Step 1 — Create an account

curl -X POST https://rendra.alphabros.eu/api/v1/users \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

The response contains your api_key. Copy it — you'll need it for every request.

Step 2 — Generate your first image

curl -X POST https://rendra.alphabros.eu/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A modern tech blog header with a purple gradient background and bold white title text",
    "width": 1200,
    "height": 630,
    "format": "png"
  }'

You'll get back a generation ID:

{
  "id": "gen_abc123",
  "status": "processing",
  "url": null
}

Step 3 — Poll for the result

curl https://rendra.alphabros.eu/api/v1/generate/gen_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "gen_abc123",
  "status": "completed",
  "url": "https://cdn.rendra.dev/gen_abc123.png",
  "width": 1200,
  "height": 630
}

That's it — drop url into your <meta property="og:image"> tag and you're done.

Tip: Use the TypeScript SDK to skip the polling loop entirely — generateAndWait() handles it for you.

Explore the Docs

Base URL

https://rendra.alphabros.eu

Rate Limits

Rate limits depend on your plan. See Billing & Usage for details. All API responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.