Aller au contenu

API d'images Open Graph

Une carte sociale pour chaque page

Concevez un seul modèle, puis laissez chaque page générer sa propre carte de partage à la demande. La balise og:image pointe directement vers Ironfang Render : pas d'étape de build, pas de bucket d'images et pas de clé dans votre balisage.

Créer un compte gratuitLire la documentation de l'API

  • Pas d'étape de build
  • Pas de stockage d'images
  • Les crawls en cache sont gratuits
  • Sans expiration, si vous le souhaitez
La carte de partage Open Graph de la page produit Ironfang Render, générée par Ironfang Render
La propre carte de partage de ce site, générée par l'API qu'il décrit.

Un seul modèle

Chaque page a besoin d'une carte, et personne ne veut de l'étape de build

Les réponses habituelles ajoutent toutes de la charge. Générez les cartes au build, et le build ralentit à chaque page et devient obsolète dès que le contenu change. Générez-les à la requête, et vous exploitez un navigateur, une file d'attente et un bucket. Passez-vous-en, et chaque partage se ressemble.

Une URL de rendu signée supprime entièrement l'intermédiaire. La balise pointe vers Ironfang Render, la carte est générée à la première requête puis servie depuis le cache, et modifier le modèle modifie toutes les cartes sans toucher à votre application.

POST /render/v1/sign
Authorization: Bearer if_live_...

{
  "kind": "image",
  "template": "og-card",
  "vars": { "title": "Why we own our hardware" },
  "width": 1200,
  "height": 630,
  "ttl_hours": 0
}

<meta property="og:image" content="https://..." >

Fonctionnalités

Ce que la balise vous apporte

La carte est générée par le même moteur de modèles que vos autres images, et livrée par une URL que vous pouvez placer n'importe où.

Un modèle, toutes les pages

Concevez la carte une fois en HTML et CSS en 1200 x 630. Chaque page transmet son propre titre, auteur, prix ou catégorie en variables.

Directement dans og:image

Une URL signée génère le rendu à la demande à l'URL elle-même : la balise pointe vers Ironfang Render plutôt que vers un fichier que votre application aurait dû créer et héberger.

Changez de design sans rebuild

Modifiez le modèle enregistré et chaque carte suit, y compris celles déjà partagées. Pas d'étape de build, pas de cache à purger, pas de rattrapage.

Les robots ne coûtent rien de plus

La première requête génère le rendu, et chaque requête identique ensuite est servie depuis le cache. Les crawls répétés de la même carte ne consomment pas de crédits.

Aucune clé dans le balisage

Votre serveur signe l'URL. La signature couvre les paramètres : le modèle et les variables ne peuvent pas être modifiés par quiconque détient le lien.

Aucun framework à adopter

C'est une URL dans une balise meta. Next.js, Astro, Rails, Laravel ou un site statique l'utilisent tous de la même façon, sans rien ajouter à votre environnement d'exécution.

Cas d'usage

Des pages qui méritent leur propre carte

Partout où un lien partagé doit s'expliquer de lui-même plutôt que d'afficher la même image pour tout le site.

Cartes d'articles et de blog

Une carte par article avec le titre et l'auteur, générée la première fois que quelqu'un le partage.

Partage de produits et d'annonces

Affichez le nom du produit, son prix et son image dans l'aperçu plutôt qu'une carte générique du site.

Pages de documentation

Donnez à chaque page de la référence sa propre carte, pour qu'un lien profond partagé soit lisible.

Liens d'événements et de réservations

Placez la date, le lieu et le titre dans l'aperçu, pour qu'un lien partagé s'explique de lui-même.

Pages créées par les utilisateurs

Les profils et les tableaux publics obtiennent leurs propres cartes sans qu'une file de tâches ne génère d'images.

Changelog et notes de version

Chaque version se partage avec son propre numéro et son propre titre, à partir du même modèle.

Vous générez d'autres images à partir de données ?

Les cartes sociales ne sont qu'un usage du moteur de modèles. Certificats, badges, visuels produit et images marketing personnalisées fonctionnent tous de la même façon, à partir du même HTML enregistré.

Tarifs

Un crédit par carte, et les crawls viennent du cache

Commencez avec 250 crédits gratuits chaque mois, sans carte bancaire. Une carte coûte un crédit la première fois qu'elle est générée, et chaque requête identique ensuite est servie depuis le cache sans rien coûter : les crawls répétés de la même page sont donc gratuits. Le travail échoué est remboursé, et atteindre un plafond interrompt le rendu au lieu de facturer un dépassement.

Voir les tarifs d'Ironfang RenderComparer avec d'autres fournisseurs

Questions

Avant de vous lancer

Les détails qui décident si la solution vous convient, sans lire d'abord toute la référence.

Dois-je générer les images au moment du build ?
Non. Placez une URL de rendu signée dans la balise og:image : la carte est générée à la première demande, puis servie depuis le cache. Rien n'est généré pendant votre build et rien n'est stocké par votre application.
Que se passe-t-il quand je change le design ?
Mettez à jour le modèle enregistré et chaque carte suit, y compris celles déjà liées. Pas de rebuild, rien à purger, car la requête suivante génère le nouveau design.
L'URL va-t-elle expirer et casser les anciens liens ?
Seulement si vous le demandez. Les URL signées ont une durée de vie en heures, et zéro signifie qu'elles n'expirent jamais, ce dont une balise og:image a besoin.
L'URL signée expose-t-elle ma clé API ?
Non. Votre serveur crée l'URL avec la clé, et la clé ne figure jamais dans l'URL. La signature couvre les paramètres : personne ne peut modifier le modèle ou les variables et obtenir quand même un rendu.
Quelle taille doit faire la carte ?
Le modèle porte sa propre largeur et sa propre hauteur : réglez-le une fois sur les 1200 x 630 qu'attendent les grandes plateformes, et chaque rendu correspond.
Puis-je l'utiliser avec Next.js, Astro ou un autre framework ?
Oui. C'est une URL ordinaire dans une balise meta : tout ce qui génère du HTML peut l'utiliser. Il n'y a pas de SDK à adopter ni d'environnement d'exécution à ajouter à votre application.
Combien cela coûte-t-il ?
Un crédit par image générée, et les répétitions de la même URL sont servies gratuitement depuis le cache. Les robots qui demandent plusieurs fois la même carte ne vous coûtent pas de crédits.

Moins à exploiter. Plus à livrer.

Donnez à chaque page sa propre carte

Créez un compte, enregistrez un modèle et signez une URL. La première carte est comprise dans vos crédits gratuits.

250 crédits gratuits chaque mois, sans carte bancaire, avec des plafonds d'utilisation stricts et des réponses en cache gratuites.