Zum Inhalt springen
POST AI agent ready /v1/og/generate

OG Image API – Kostenloser Open Graph Generator

Erstellen Sie gebrandete Open Graph-Bilder zum Teilen in sozialen Netzwerken. Übergeben Sie einen Titel und eine optionale Beschreibung, wählen Sie ein helles oder dunkles Thema, legen Sie eine Akzentfarbe fest und geben Sie Ihre Logo-URL an. Die API gibt ein gebrauchsfertiges PNG zurück, das Sie als og:image-Meta-Tag verwenden können.

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

Dynamische Vorschau von Blogbeiträgen

Generieren Sie zum Zeitpunkt der Veröffentlichung ein einzigartiges OG-Bild für jeden Blog-Beitrag. Übergeben Sie den Beitragstitel und den Auszug an die API, speichern Sie das resultierende PNG in Ihrem CDN zwischen und jeder Social Share erhält eine Markenvorschau ohne manuelle Designarbeit.

SaaS-Dashboard-Share-Karten

Wenn Benutzer einen Bericht oder einen Dashboard-Link teilen, generieren Sie im Handumdrehen ein OG-Bild, das den Berichtstitel und eine zusammenfassende Statistik enthält. Empfänger sehen eine umfangreiche Vorschau anstelle eines generischen Fallbacks.

E-Commerce-Produktkarten

Erstellen Sie soziale Vorschaubilder für Produktseiten, indem Sie den Produktnamen, den Preis und die Markenfarbe übergeben. Jeder auf Twitter, Slack oder LinkedIn geteilte Produktlink ergibt eine ausgefeilte Karte.

Frequently asked questions

Welche Abmessungen verwendet das generierte OG-Bild?
Die API gibt eine PNG-Größe von 1200 x 630 zurück, die empfohlene Größe für Open Graph- und Twitter Card-Bilder. Diese Auflösung wird auf Facebook, LinkedIn, Twitter, Slack und Discord gut angezeigt.
Kann ich eine benutzerdefinierte Schriftart verwenden?
Die API wird mit einer sauberen serifenlosen Schriftart geliefert, die für die Lesbarkeit bei Social-Media-Vorschaugrößen optimiert ist. Das Hochladen benutzerdefinierter Schriftarten wird derzeit nicht unterstützt.
Wie kann ich dies als mein og:image-Tag bereitstellen?
Sie können entweder die API zur Erstellungszeit aufrufen, das PNG in Ihrem CDN speichern und in Ihrem Meta-Tag auf diese URL verweisen. oder verweisen Sie die og:image-URL direkt auf den API-Endpunkt, wenn Sie die On-Demand-Generierung bevorzugen.
Wird die Antwort zwischengespeichert?
Die API speichert keine Antworten zwischen. Wenn Sie dieselben Parameter zweimal senden, wird jedes Mal ein neues Bild generiert. Speichern Sie das Ergebnis für den Produktionsgebrauch in Ihrem eigenen CDN oder Objektspeicher.
Was passiert, wenn ich die Beschreibung weglasse?
Das Bild wird nur mit dem Titel gerendert, vertikal zentriert. Dies eignet sich gut für kurze, aussagekräftige Schlagzeilen.

Get your API key

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