Documentation
Couvertures d'articles : quand elles sont dessinées et comment elles sont vérifiées
Quand le moteur de contenu dessine une couverture, comment la scène sans marque et l'image sont créées et vérifiées, le fichier que reçoit votre site, et comment fournir votre propre image.
Si votre site affiche une image de couverture avec chaque article, le moteur de contenu en fournit une pour chacun. Le rédacteur d'AutoPSEO dessine la couverture pendant qu'il écrit, dans le style de vos couvertures existantes, et un modèle de vision écarte toute image contenant un logo ou du texte lisible. Votre propre IA peut apporter sa propre image à la place. Les couvertures sont des JPEG de 1536 par 1024 pixels, livrés avec l'article, et elles ne consomment ni votre quota d'articles ni vos crédits de recherche.
Quand un article reçoit une couverture
AutoPSEO ne dessine des couvertures que pour un site qui les affiche :
- Votre site affiche les articles via le webhook et a indiqué qu'il affiche des couvertures : sa réponse au ping contient
covers: true, ou il a répondu au moins une fois à une livraison aveccover: "wanted". À partir de là, le rédacteur d'AutoPSEO dessine la couverture juste après avoir enregistré chaque brouillon, si bien que la première livraison de l'article la contient déjà. - Un article est arrivé sans couverture. Répondez à cette livraison avec
cover: "wanted": la planification toutes les cinq minutes en dessine une, en traitant d'abord la demande la plus ancienne, et vous l'envoie dans unarticle.updated. - AutoPSEO héberge les articles et le modèle appris à partir de votre site affiche des couvertures (hébergement).
Un site qui n'affiche pas de couvertures n'en reçoit aucune. La planification toutes les cinq minutes abandonne un article après trois tentatives échouées. Un article en ligne conserve sa couverture jusqu'à ce que quelqu'un la remplace avec content_set_cover ; une révision en attente de relecture ne la modifie jamais.
Comment une couverture est dessinée
- La scène. Un modèle de texte sur Workers AI (Llama 3.3) décrit une scène d'au plus 45 mots pour l'article : des personnes génériques, le lieu, ce qu'elles font, les objets qui les entourent. Il ne nomme aucune entreprise, marque, produit, application, site web, école, personne ni lieu, et ne place rien de lisible dans l'image. Une scène qui nomme encore votre marque est refusée. Le modèle d'image ne voit jamais l'article lui-même.
- L'image. FLUX.2 [klein] dessine la scène « in exactly the style, lighting, palette and framing » d'au plus deux de vos propres images de partage ou couvertures, utilisées comme références. Sans références, il dessine une photographie éditoriale calme, en lumière naturelle. Le prompt demande aucun texte, lettre, chiffre, logo ni filigrane, des formes abstraites sur tous les écrans, et des ordinateurs portables, téléphones et moniteurs unis et sans marque.
- La vérification. Un modèle de vision (Llama 4 Scout) examine le résultat. Une image contenant un logo ou du texte lisible compte comme une tentative échouée et est redessinée lors d'une exécution ultérieure.
L'étape de couverture du rédacteur n'est jamais relancée d'elle-même. Si elle échoue, l'article poursuit son cours sans rien bloquer.
Le fichier que reçoit votre site
| Propriété | Valeur |
|---|---|
| Format | JPEG |
| Taille | 1536 par 1024 pixels, un ratio de 3:2 |
| Adresse | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Mise en cache | Publique et immuable pendant un an : le nom du fichier est le SHA-256 de l'image |
Les livraisons la transmettent sous article.cover avec url, sha256, contentType, width et height. Récupérez-la une fois et conservez votre propre copie ; votre site est propriétaire de l'image, comme du reste de l'article. Avec l'hébergement AutoPSEO, les couvertures sont servies sous le chemin du type de contenu à l'adresse /_cover/<slug>.jpg, dans les tailles et les formats qu'utilise votre modèle.
Fournir votre propre image
Un rédacteur travaillant via MCP peut fournir n'importe quelle image, créée comme il le souhaite (votre propre IA) :
- Avec le brouillon : le paramètre
coverdecontent_submit, soiturl(une adresse https sur le web public, récupérée une seule fois), soitdata(base64, jusqu'à 2.5 Mo). - Sous forme de fichier : un PUT des octets de l'image vers le
coverUploadUrlquecontent_submitrenvoie lorsque votre site veut une couverture. - Plus tard :
content_set_coveravec une image, ou sans image pour obtenir une adresse d'envoi. C'est aussi ainsi que l'on remplace la couverture d'un article en ligne.
AutoPSEO ne vérifie votre image qu'en tant qu'image : PNG, JPEG ou WebP, entre 10 Ko et 12 Mo, d'au moins 800 pixels de large et 400 de haut, et en format paysage (pas plus haute que large, pas plus large que 2.5 pour 1). Elle est recadrée au centre en 3:2 et enregistrée sous forme de JPEG de 1536 par 1024. La vérification par le modèle de vision ne s'applique pas à votre propre image, et celle-ci est conservée même lorsqu'AutoPSEO ne sait pas si votre site affiche des couvertures : c'est votre site qui décide.
Dessiner à partir du prompt d'AutoPSEO
Un rédacteur disposant de son propre outil d'image peut tout de même utiliser le prompt et les vérifications d'AutoPSEO :
- Décrivez une scène de 20 à 600 caractères et envoyez-la avec
content_cover. AutoPSEO la vérifie comme ses propres scènes et renvoie le prompt d'image, jusqu'à deux couvertures de votre site comme références et une adresse d'envoi signée. - Dessinez l'image à partir de ce prompt avec l'outil d'image de votre choix, puis envoyez les octets par PUT à l'adresse. Elle reste valide une heure et accepte jusqu'à cinq images.
- AutoPSEO redimensionne l'image à 1536 par 1024, exécute la vérification par le modèle de vision et la conserve. Un article en ligne est renvoyé à votre site avec sa nouvelle couverture.
| Réponse à l'envoi | Signification |
|---|---|
| 403 | L'adresse est invalide ou a expiré |
| 413 | Plus de 12 Mo |
| 415 | Ce n'est pas une image |
| 422 | La vérification l'a refusée : redessinez-la et envoyez-la à la même adresse |
| 429 | L'adresse a reçu cinq images ; demandez-en une nouvelle |
| 409 | Le site n'affiche pas de couvertures |
Le runner autonome décrit dans votre propre IA utilise ce flux avec son outil make_cover, en dessinant avec le Codex CLI ou le Grok CLI sur votre propre Mac.