Aller au contenu
POST AI agent ready /v1/og/generate

OG Image API - Générateur de graphiques ouverts gratuit

Créez des images Open Graph de marque pour le partage social. Transmettez un titre et une description facultative, choisissez un thème clair ou sombre, définissez une couleur d'accentuation et incluez l'URL de votre logo. L'API renvoie un PNG prêt à l'emploi que vous pouvez servir de balise méta og:image.

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

Aperçus dynamiques des articles de blog

Générez une image OG unique pour chaque article de blog au moment de la publication. Transmettez le titre et l'extrait de la publication à l'API, mettez en cache le PNG résultant sur votre CDN et chaque partage social obtient un aperçu de marque sans travail de conception manuel.

Cartes de partage du tableau de bord SaaS

Lorsque les utilisateurs partagent un lien de rapport ou de tableau de bord, générez à la volée une image OG qui inclut le titre du rapport et une statistique récapitulative. Les destinataires voient un aperçu enrichi au lieu d’une solution de secours générique.

Fiches produits e-commerce

Créez des images d'aperçu social pour les pages de produits en transmettant le nom du produit, le prix et la couleur de la marque. Chaque lien de produit partagé sur Twitter, Slack ou LinkedIn génère une carte soignée.

Frequently asked questions

Quelles dimensions l'image OG générée utilise-t-elle ?
L'API renvoie un PNG de 1 200 x 630, la taille recommandée pour les images Open Graph et Twitter Card. Cette résolution s'affiche bien sur Facebook, LinkedIn, Twitter, Slack et Discord.
Puis-je utiliser une police personnalisée ?
L'API est livrée avec une police sans empattement épurée, optimisée pour la lisibilité dans les tailles d'aperçu des réseaux sociaux. Les téléchargements de polices personnalisées ne sont pas pris en charge pour le moment.
Comment puis-je utiliser ceci comme balise og:image ?
Vous pouvez soit appeler l'API au moment de la construction, enregistrer le PNG sur votre CDN et référencer cette URL dans votre balise méta ; ou pointez l'URL og:image directement sur le point de terminaison de l'API si vous préférez la génération à la demande.
La réponse est-elle mise en cache ?
L'API ne met pas en cache les réponses. Si vous envoyez les mêmes paramètres deux fois, il génère à chaque fois une nouvelle image. Pour une utilisation en production, stockez le résultat sur votre propre CDN ou stockage d'objets.
Que se passe-t-il si j'omets la description ?
L'image s'affiche avec le titre uniquement, centré verticalement. Cela fonctionne bien pour les titres courts et percutants.

Get your API key

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

Sign up free View full docs