Générer des images de carte Twitter avec une API
Une image de carte Twitter (X) est l’aperçu de grande taille affiché lorsqu’un lien est partagé sur X. FastOG la génère dynamiquement en 1200×630 et signale summary_large_image, afin que chaque page dispose d’une carte X correcte sans avoir à créer une image manuellement.
Ce dont une image de carte Twitter a besoin
X lit les balises Open Graph et affiche une carte summary_large_image lorsque la page contient un lien twitter:card = summary_large_image. L’image est rendue en 1200×630. FastOG génère exactement cela, et vous pointez twitter:image vers la même URL dynamique que og:image.
Comment configurer une carte Twitter dynamique
Générez votre URL FastOG une seule fois, puis définissez à la fois les balises méta OG et Twitter avec cette URL.
<meta property="og:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="My Post">
<meta name="twitter:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
La même URL fonctionne pour les deux balises. X utilise
og:imagecomme solution de repli sitwitter:imageest absent, mais définir les deux est sans risque et explicite.
Conseils pour le validateur de cartes X
| Vérification | Détail |
|---|---|
| URL publique | L'image doit pouvoir être récupérée par X sans authentification |
| Taille / format du fichier | Restez sous 5 Mo ; le PNG est idéal pour les cartes textuelles |
| Cache | X met en cache de manière agressive — utilisez le validateur de cartes pour forcer un rafraîchissement |
| URL signées | Les URL signées par contenu de FastOG ne limitent que le premier rendu ; les cartes mises en cache restent valides |
FAQ
Dois-je utiliser des images distinctes pour X et Open Graph ?
Non. X lit la même image de 1 200 × 630 pixels. Cette page existe parce que les balises twitter:card correctes sont faciles à mal configurer.
Pourquoi ma carte X ne se met-elle pas à jour après avoir modifié le titre ?
X met en cache l’ancienne carte. Ouvrez le validateur de cartes X, collez l’URL, puis relancez l’analyse.
FastOG gère-t-il aussi les balises meta Twitter ?
FastOG génère l’image ; vous ajoutez vous-même les balises meta twitter:card et twitter:image à votre page (comme indiqué ci-dessus). Notre générateur gratuit de balises meta Open Graph écrit toutes les balises pour vous.