Documentatie
Artikelcovers: wanneer ze worden getekend en hoe ze worden gecontroleerd
Wanneer de content engine een cover tekent, hoe de merkvrije scène en afbeelding worden gemaakt en gecontroleerd, welk bestand je site ontvangt en hoe je je eigen afbeelding meegeeft.
Als je site bij elk artikel een coverafbeelding toont, geeft de content engine elk artikel er een. De schrijver van AutoPSEO tekent de cover tijdens het schrijven, in de stijl van je bestaande covers, en een vision-model gooit elke afbeelding met een logo of leesbare tekst weg. Je eigen AI kan in plaats daarvan een eigen afbeelding aanleveren. Covers zijn JPEG's van 1536 bij 1024 pixels, worden samen met het artikel geleverd en gebruiken noch je artikelbudget noch je researchcredits.
Wanneer een artikel een cover krijgt
AutoPSEO tekent alleen covers voor een site die ze toont:
- Je site rendert de artikelen via de webhook en heeft aangegeven covers te tonen: het ping-antwoord bevat
covers: true, of de site heeft minstens één keer op een levering geantwoord metcover: "wanted". Vanaf dat moment tekent de schrijver van AutoPSEO de cover direct nadat hij elk concept heeft opgeslagen, zodat al de eerste levering van het artikel de cover meebrengt. - Een artikel kwam zonder cover aan. Antwoord op die levering met
cover: "wanted": het schema van vijf minuten tekent er een, het oudste verzoek eerst, en stuurt die naar je in eenarticle.updated. - AutoPSEO host de artikelen en de template die het van je site heeft geleerd toont covers (hosting).
Een site die geen covers toont, krijgt er geen. Het schema van vijf minuten geeft een artikel op na drie mislukte pogingen. Een live artikel houdt zijn cover totdat iemand die vervangt met content_set_cover; een revisie die op review wacht, wijzigt de cover nooit.
Hoe een cover wordt getekend
- De scène. Een tekstmodel op Workers AI (Llama 3.3) beschrijft voor het artikel één scène van maximaal 45 woorden: algemene mensen, de plek, wat ze doen, de voorwerpen om hen heen. Het noemt geen bedrijf, merk, product, app, website, school, persoon of plaats en zet niets leesbaars in de afbeelding. Een scène die nog steeds je merk noemt, wordt geweigerd. Het beeldmodel ziet het artikel zelf nooit.
- De afbeelding. FLUX.2 [klein] tekent de scène "in exactly the style, lighting, palette and framing" van maximaal twee van je eigen deelafbeeldingen of covers, die als referentie dienen. Zonder referenties tekent het een rustige editorial foto bij natuurlijk licht. De prompt vraagt om geen tekst, letters, cijfers, logo's of watermerken, geen abstracte vormen op schermen en om neutrale laptops, telefoons en monitoren zonder merknaam.
- De controle. Een vision-model (Llama 4 Scout) bekijkt het resultaat. Een afbeelding met een logo of leesbare tekst telt als een mislukte poging en wordt bij een latere run opnieuw getekend.
De coverstap van de schrijver wordt nooit uit zichzelf opnieuw geprobeerd. Mislukt hij, dan gaat het artikel gewoon door zonder dat er iets wordt tegengehouden.
Het bestand dat je site ontvangt
| Eigenschap | Waarde |
|---|---|
| Formaat | JPEG |
| Afmetingen | 1536 bij 1024 pixels, een verhouding van 3:2 |
| Adres | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Caching | Openbaar en een jaar onveranderlijk: de bestandsnaam is de SHA-256 van de afbeelding |
Leveringen bevatten de cover als article.cover met url, sha256, contentType, width en height. Haal het bestand één keer op en bewaar je eigen kopie; je site is eigenaar van de afbeelding, net als van de rest van het artikel. Bij hosting door AutoPSEO worden covers geserveerd onder het pad van het contenttype op /_cover/<slug>.jpg, in de afmetingen en formaten die je template gebruikt.
Lever je eigen afbeelding aan
Een schrijver die via MCP werkt, kan elke afbeelding aanleveren die hij wil, op de manier die hij wil (je eigen AI):
- Samen met het concept: het veld
covervancontent_submit, meturl(een https-adres op het openbare web, dat één keer wordt opgehaald) ofdata(base64, tot 2,5 MB). - Als bestand: een PUT van de afbeeldingsbytes naar de
coverUploadUrldiecontent_submitteruggeeft wanneer je site een cover wil. - Later:
content_set_covermet een afbeelding, of zonder afbeelding om een uploadadres te krijgen. Zo vervang je ook de cover van een live artikel.
AutoPSEO controleert je afbeelding alleen als beeld: PNG, JPEG of WebP, tussen 10 KB en 12 MB, minstens 800 pixels breed en 400 hoog, en liggend (niet hoger dan breed, niet breder dan 2,5 op 1). De afbeelding wordt gecentreerd bijgesneden tot 3:2 en opgeslagen als JPEG van 1536 bij 1024. De visiecontrole draait niet op je eigen afbeelding, en de afbeelding blijft behouden, zelfs als AutoPSEO niet weet of je site covers toont: dat beslist je site.
Tekenen met de prompt van AutoPSEO
Een schrijver met een eigen beeldtool kan toch de prompt en controles van AutoPSEO gebruiken:
- Beschrijf een scène van 20 tot 600 tekens en stuur die met
content_cover. AutoPSEO controleert de scène zoals zijn eigen scènes en geeft de afbeeldingsprompt terug, tot twee covers van je site als referentie en een ondertekend uploadadres. - Teken de afbeelding met die prompt in een willekeurige beeldtool en doe een PUT van de bytes naar het adres. Het adres werkt een uur en accepteert maximaal vijf afbeeldingen.
- AutoPSEO schaalt de afbeelding naar 1536 bij 1024, voert de visiecontrole uit en bewaart de afbeelding. Een live artikel wordt opnieuw naar je site gestuurd met de nieuwe cover.
| Uploadantwoord | Betekenis |
|---|---|
| 403 | Het adres is ongeldig of verlopen |
| 413 | Groter dan 12 MB |
| 415 | Geen afbeelding |
| 422 | De controle heeft de afbeelding geweigerd: teken opnieuw en stuur naar hetzelfde adres |
| 429 | Het adres heeft vijf afbeeldingen ontvangen; vraag een nieuw adres aan |
| 409 | De site toont geen covers |
De onbemande runner die wordt beschreven in je eigen AI gebruikt deze werkwijze met zijn tool make_cover en tekent met de Codex CLI of de Grok CLI op je eigen Mac.