コンテンツへスキップ
POST AI agent ready /v1/og/generate

OG Image API - 無料のオープン グラフ ジェネレーター

ソーシャル共有用にブランド化された Open Graph 画像を作成します。 タイトルとオプションの説明を渡し、明るいテーマまたは暗いテーマを選択し、アクセントカラーを設定し、ロゴの URL を含めます。 API は、og:image メタ タグとして使用できる、すぐに使用できる PNG を返します。

Parameters

stringrequired

Primary text rendered on the image. Keep it under 60 characters for best results.

string

Secondary text rendered below the title. Optional but recommended for context.

string

Background theme for the generated image.

string

Accent color as a hex code (include the #). Applied to highlights and borders.

string

URL to a logo image displayed on the card. PNG or SVG recommended.

Code examples

curl -X POST https://api.botoi.com/v1/og/generate \
  -H "Content-Type: application/json" \
  -d '{"title":"Ship faster with the Botoi API","description":"150+ developer endpoints, zero infrastructure to manage.","theme":"dark","color":"#3b82f6","logo":"https://botoi.com/logo.png"}'

When to use this API

動的なブログ投稿のプレビュー

公開時にブログ投稿ごとに一意の OG イメージを生成します。 投稿のタイトルと抜粋を API に渡し、結果の PNG を CDN にキャッシュすると、手動でのデザイン作業を行わずに、すべてのソーシャル共有にブランド付きのプレビューが表示されます。

SaaS ダッシュボード共有カード

ユーザーがレポートまたはダッシュボードのリンクを共有する場合、レポートのタイトルと概要統計を含む OG イメージをオンザフライで生成します。 受信者には、一般的なフォールバックではなく、豊富なプレビューが表示されます。

Eコマース商品カード

製品名、価格、ブランドカラーを渡して、製品ページのソーシャル プレビュー画像を作成します。 Twitter、Slack、LinkedIn で共有される各製品リンクは、洗練されたカードをレンダリングします。

Frequently asked questions

生成された OG イメージはどのようなサイズを使用しますか?
API は、Open Graph および Twitter Card 画像の推奨サイズである 1200x630 PNG を返します。 この解像度は、Facebook、LinkedIn、Twitter、Slack、Discord 全体で適切に表示されます。
カスタムフォントを使用できますか?
API には、ソーシャル メディアのプレビュー サイズで読みやすいように最適化されたきれいなサンセリフ フォントが付属しています。 現時点では、カスタム フォントのアップロードはサポートされていません。
これを og:image タグとして提供するにはどうすればよいですか?
ビルド時に API を呼び出し、PNG を CDN に保存し、メタ タグでその URL を参照できます。 または、オンデマンド生成を希望する場合は、og:image URL を API エンドポイントに直接指定します。
応答はキャッシュされていますか?
API は応答をキャッシュしません。 同じパラメータを 2 回送信すると、毎回新しいイメージが生成されます。 運用環境で使用する場合は、結果を独自の CDN またはオブジェクト ストレージに保存します。
説明を省略するとどうなりますか?
画像はタイトルのみを垂直方向の中央に配置してレンダリングされます。 これは、短くてパンチのある見出しに適しています。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.