# OG Image Generator

Generate Open Graph images and social cards from a title: blog, product and docs layouts, your logo and colours, PNG, JPEG or WebP.

Send a title and pick a layout (standard, blog, product, docs or plain); get back a card for Open Graph, X, LinkedIn or square posts as PNG, JPEG or WebP. Add your logo, an author byline, your colours or a gradient. Text is wrapped and sized to fit, never clipped. Latin and Cyrillic script; emoji are refused before any charge.

- Text is wrapped and sized to fit. A title can be up to 140 characters and a subtitle up to 200.
- Five layouts (standard, blog, product, docs, plain), sizes for Open Graph, X, LinkedIn and square posts, PNG, JPEG or WebP.
- Your logo, author photo and byline (author, date, reading time), your colours or a gradient. Images travel in the request; no link is fetched.
- No headless browser and no template to host: one call, one image.
- Latin and Cyrillic script. Anything that cannot be drawn is refused before any charge.

## Calls

### `POST https://readymadeapi.com/v1/og-card`

Render one social card from a title: five layouts, four sizes, PNG, JPEG or WebP, with your logo and colours.

- Price: $0.002 per image
- MCP tool: `og_card_render`
- Answers in the same call.

Request:

```json
{
  "eyebrow": "Field Notes / blog",
  "footer": "fieldnotes.blog",
  "subtitle": "A field guide to calm releases",
  "title": "Ship it on a Friday"
}
```

The answer is the file itself (`image/png`).

## Limits

- Title up to 140 characters, subtitle up to 200.
- Logo and avatar up to 512 KB each, sent as base64; no image is fetched from a link.
- Sizes 1200x630, 1200x675, 1200x627 and 1080x1080.

## Questions

**Where do the cards look right?**

X, LinkedIn, Slack, iMessage and anywhere else that reads og:image at 1200x630.

**Can I add my logo and colours?**

Yes. Send the logo as base64 in logo_base64 (PNG, JPEG or WebP, up to 512 KB). Set background, background_to for a gradient, text_color and accent as #RRGGBB, or use the dark and light themes. Text colours too close to the background to read are refused before any charge.

**Which layouts and sizes?**

Layouts: standard, blog (byline with avatar, author, date and reading time), product (your logo on a panel in your accent colour), docs (grid and frame) and plain. Sizes: og 1200x630, x 1200x675, linkedin 1200x627 and square 1080x1080.

**Can I use a background photo?**

No: the card is typographic, so the text stays readable. A colour or a two-colour gradient is the background.

**Are emoji drawn?**

Not drawn. A title with emoji is refused and not charged, so you never publish a card with empty boxes.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
