ForHosting KIT · Images

Image Open Graph

L’image Open Graph est l’aperçu qui apparaît lorsqu’un lien est partagé sur un réseau social ou une messagerie. Cet outil la produit à la bonne dimension, à partir d’un titre ou d’un visuel, pour que vos pages s’affichent avec une vignette soignée plutôt qu’un cadre vide.

● Stablepar requête + par image$0.040

Lancer — $0.040 + $0.001/image Voir l’API

Utilisez-le depuis WebAPIE-mailApp bientôtTelegram bientôt

Exécuter en ligne

Exécutez cette tâche sur nos serveurs, avec votre compte. Les outils gratuits tournent dans votre navigateur ; celui-ci est facturé sur votre solde KIT au prix affiché ci-dessus.

L’aperçu qui décide du clic

Quand un lien est partagé, la plupart des plateformes affichent une vignette, un titre et une description tirés des balises de la page. Sans image Open Graph, le lien apparaît nu, moins engageant, et récolte moins de clics. Une vignette nette, aux bonnes proportions, avec un titre lisible, donne une première impression professionnelle et incite à ouvrir. C’est un détail souvent négligé qui pèse pourtant sur la diffusion d’un article, d’une fiche produit ou d’une page d’accueil dès qu’elle circule en dehors de votre site.

Une dimension et un cadrage maîtrisés

Les plateformes recadrent l’aperçu selon un format large ; un visuel mal calibré se retrouve tronqué ou étiré. L’outil génère l’image à la dimension attendue, avec le texte placé de façon à rester visible après recadrage. Vous gardez la cohérence de votre marque : mêmes couleurs, même logo, même mise en page d’une page à l’autre. Plutôt que de bricoler une capture au mauvais format, vous obtenez un aperçu régulier, pensé pour s’afficher proprement aussi bien sur mobile que sur ordinateur.

Du web à la génération en série

Cette page produit l’image à la demande. Pour un site qui publie souvent — un blog, une boutique, un média —, générer automatiquement l’aperçu de chaque nouvelle page fait gagner un temps réel : la même capacité s’appelle via l’API et s’intègre au flux de publication, avec l’arrivée prochaine des autres canaux. Un usage ponctuel se règle ici en quelques secondes ; une production régulière gagne à automatiser l’étape pour ne jamais publier une page sans son aperçu.

Cas d’usage

Un article de blog partageable

Le Studio Lumen SAS publie un billet et veut qu’il s’affiche joliment sur les réseaux. L’image Open Graph reprend le titre et les couleurs du site, pour un aperçu net plutôt qu’un cadre vide au partage.

Une fiche produit qui circule

L’Atelier Garnier SARL partage le lien d’un meuble en promotion. L’aperçu Open Graph montre le produit et son nom, ce qui attire l’œil dans une conversation de messagerie ou un fil social.

Une page d’événement

Nadia Benali diffuse le lien d’un événement associatif. L’image Open Graph affiche la date et l’intitulé, pour que le partage donne envie de cliquer plutôt qu’un simple lien sans visuel.

Questions fréquentes

À quoi sert exactement une image Open Graph ?

C’est l’aperçu visuel affiché quand votre lien est partagé sur un réseau social ou une messagerie. Elle remplace le cadre vide par une vignette soignée qui donne envie de cliquer.

Quelles proportions doit avoir cette image ?

L’outil la génère au format large attendu par les plateformes, avec le texte placé pour rester visible après recadrage. Vous n’avez pas à connaître les dimensions exactes : elles sont respectées automatiquement.

Comment l’activer sur ma page ?

Vous placez l’image renvoyée sur votre site et la déclarez dans l’en-tête de la page via la balise prévue à cet effet. Les plateformes la reprennent ensuite au partage du lien.

Combien coûte la génération d’un aperçu ?

Le tarif est de $0.040 par requête et de $0.001 par image, en dollars US. Sans abonnement : vous payez à l’usage, uniquement les aperçus réellement générés.

Mes contenus sont-ils conservés après la génération ?

Non. Le titre et le visuel fournis servent à produire l’image, puis ne sont pas conservés. Rien n’est archivé ni réutilisé une fois l’aperçu renvoyé.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/image/og

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/image/og \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/image/og", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/og",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/og", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/og", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.og",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.040

par image$0.001

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

`max_mb`	15
`max_megapixels`	12

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.
`422`	`task_failed`	La tâche a échoué : elle ne vous est pas facturée.

Consulter la documentation complète du KIT →