URL signées et temporaires
Chaque paramètre de requête est signé en HMAC-SHA256 avec votre clé, et chaque URL a une date d’expiration. Personne ne peut dépenser vos crédits en modifiant le titre.
Rendra transforme une URL signée en carte sociale 1200×630. Choisissez un modèle, transmettez le titre et la description dans les paramètres de requête, puis signez-les avec votre clé API : les robots reçoivent un PNG, mis en cache pendant un jour et facturé une seule fois. Une URL signée devient une carte sociale 1200×630. Choisissez un modèle, transmettez le titre et la description, puis signez-les avec votre clé API. Les robots reçoivent un PNG, mis en cache pendant un jour et facturé une seule fois.
50 rendus gratuits par mois. Sans carte bancaire. Connexion avec Google ou par lien magique. 50 rendus gratuits par mois. Sans carte bancaire.
// the URL in your <meta property="og:image">
https://rendra.alphabros.eu/i/og_standard
?title=Ship+faster
&description=Beautiful+social+cards+from+one+URL
&expires=1788393600
&sig=<key id>.<hmac-sha256 of the sorted query>
// sign it once, server-side (Node)
const digest = createHmac("sha256", RENDRA_API_KEY)
.update(`${path}?${query}`)
.digest("hex");
query.set("sig", `${RENDRA_API_KEY_ID}.${digest}`);
Les robots sociaux récupèrent og:image avec un simple GET. Rendra rend ce GET sûr, économique et reproductible.
Chaque paramètre de requête est signé en HMAC-SHA256 avec votre clé, et chaque URL a une date d’expiration. Personne ne peut dépenser vos crédits en modifiant le titre.
Deux modèles aujourd’hui : og_standard pour les cartes permanentes et announcement pour les lancements. Les modèles personnalisés figurent sur la feuille de route Pro.
Les rendus identiques reviennent du cache avec X-Cached: true et ne coûtent rien. Les réponses restent publiques et immuables pendant 24 heures maximum.
Connectez-vous avec Google ou un lien magique. Créez des clés API nommées, révoquez-en une sans toucher aux autres et suivez l’utilisation de votre quota mensuel.
Votre historique de génération se trouve dans le tableau de bord et sur /api/v1/dashboard/history, afin de voir ce qui a été livré et quand.
Envoyez un prompt avec POST, puis consultez l’état de l’image. Une chaîne de fournisseurs assure le basculement automatique. Actuellement en préversion, hors des offres ci-dessous.
Tout ce qui suit figure dans la spécification OpenAPI sur /openapi.yaml.
Un appel public avec votre e-mail crée le compte et renvoie la clé et son identifiant. Vous pouvez aussi vous connecter et créer des clés nommées dans le tableau de bord.
$ curl -X POST \
https://rendra.alphabros.eu/api/v1/users \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'
201 Created
{ "id": "…", "email": "you@example.com",
"api_key": "rendra_…", "plan": "free" }
Triez la requête, signez le chemin et la requête en HMAC-SHA256 avec votre clé, puis ajoutez sig sous la forme identifiant de clé, point et condensé hexadécimal.
const path = "/i/og_standard";
const query = new URLSearchParams({
title: "Ship faster",
description: "Beautiful social cards…",
expires: String(Math.floor(Date.now() / 1000) + 3600),
});
query.sort();
// sig = keyId + "." + hmac(path+"?"+query)
Placez l’URL dans votre balise og:image. Les robots reçoivent le PNG ; une signature incorrecte ou expirée renvoie 403, et un quota épuisé 402.
GET /i/og_standard?title=…&expires=…&sig=…
200 OK
Content-Type: image/png
Cache-Control: public, max-age=86400, immutable
X-Cached: false
403 { "error": "Invalid or expired signature" }
402 { "error": "Credit limit exceeded" }
Vous effectuez le rendu côté serveur ? Envoyez POST /api/v1/render avec les mêmes champs template, data, width, height et format, ainsi que votre clé API.
Un rendu vaut un crédit. Les crédits sont réinitialisés chaque mois. Les accès au cache ne sont jamais comptés.
Projets personnels, tests et petits blogs.
Entreprises, agences et blogs à fort trafic.
Crédits supplémentaires : 0,50 € par tranche de 10. Les crédits inutilisés ne sont pas reportés. Garantie de remboursement de 30 jours.
50 rendus gratuits par mois. Signez votre première URL le temps de lire la spécification.
Obtenir votre clé API gratuite