Generate OG images dynamically with a single URL.
Pass your API key as a query parameter or Authorization: Bearer header.
# Query parameterhttps://og.planhub.kr/v1/og?title=Hello&api_key=og_live_...# Authorization headercurl https://og.planhub.kr/v1/og?title=Hello \ -H "Authorization: Bearer og_live_..."
| Parameter | Type | Description | |
|---|---|---|---|
title | string | required | Main text displayed on the image. Max 120 characters. |
subtitle | string | optional | Secondary text below the title. |
theme | string | optional | Visual theme. Options: dark (default), light, minimal, vibrant. |
platform | string | optional | Platform preset: twitter, kakao, slack, whatsapp. Auto-adjusts size and format. |
api_key | string | optional | Your API key. Required for paid plans. Can also be sent as Bearer token. |
On success: 200 image/png or image/jpeg binary. On rate limit: 429.
| Response Header | Description |
|---|---|
Content-Type | image/png or image/jpeg |
X-RateLimit-Limit | Maximum requests for your plan this month. |
X-RateLimit-Remaining | Remaining requests this month. |
X-RateLimit-Reset | ISO 8601 timestamp when the counter resets. |
X-OGShot-Cache | HIT if served from cache, MISS if freshly rendered. |
<!-- og:image meta 태그 하나면 끝 --><meta property="og:image" content="https://og.planhub.kr/v1/og ?title=나의 블로그 글 제목 &theme=dark &api_key=YOUR_KEY" />
| Plan | Monthly Limit | Overage |
|---|---|---|
| Free | 50 images | 429 error (no overage) |
| Hobby | 500 images | $3 / 1,000 images |
| Starter | 3,000 images | $3 / 1,000 images |
| Pro | 15,000 images | $3 / 1,000 images |
| Scale | 100,000 images | $3 / 1,000 images |
Cached images do not count against your quota. The counter resets on the 1st of each month (UTC).