Documentazione
Copertine degli articoli: quando vengono create e come vengono verificate
Quando il content engine genera una copertina, come vengono create e verificate la scena senza brand e l'immagine, il file che riceve il tuo sito e come usare un'immagine tua.
Se il tuo sito mostra un'immagine di copertina con ogni articolo, il content engine ne assegna una a ciascun articolo. Il writer di AutoPSEO genera la copertina mentre scrive, nello stile delle tue copertine esistenti, e un modello di visione scarta qualsiasi immagine con un logo o con testo leggibile. La tua AI può invece portare un'immagine propria. Le copertine sono JPEG da 1536 per 1024 pixel, consegnate insieme all'articolo, e non consumano né la quota di articoli né i crediti di ricerca.
Quando un articolo riceve una copertina
AutoPSEO genera le copertine solo per i siti che le mostrano:
- Il tuo sito renderizza gli articoli tramite il webhook e ha dichiarato di mostrare le copertine: la risposta al ping contiene
covers: true, oppure ha risposto almeno una volta a una consegna concover: "wanted". Da quel momento il writer di AutoPSEO genera la copertina subito dopo aver salvato ogni bozza, così la prima consegna dell'articolo la include già. - Un articolo è arrivato senza copertina. Rispondi a quella consegna con
cover: "wanted": la pianificazione ogni cinque minuti ne genera una, partendo dalla richiesta più vecchia, e te la invia in unarticle.updated. - AutoPSEO ospita gli articoli e il template appreso dal tuo sito prevede le copertine (hosting).
Un sito che non mostra copertine non ne riceve. La pianificazione ogni cinque minuti rinuncia a un articolo dopo tre tentativi falliti. Un articolo pubblicato mantiene la propria copertina finché qualcuno non la sostituisce con content_set_cover; una revisione in attesa di approvazione non la modifica mai.
Come viene generata una copertina
- La scena. Un modello di testo su Workers AI (Llama 3.3) descrive per l'articolo una scena di al massimo 45 parole: persone generiche, il luogo, cosa fanno, gli oggetti intorno a loro. Non nomina alcuna azienda, marchio, prodotto, app, sito web, scuola, persona o luogo e non inserisce nell'immagine nulla di leggibile. Una scena che nomina ancora il tuo brand viene rifiutata. Il modello di immagini non vede mai l'articolo stesso.
- L'immagine. FLUX.2 [klein] disegna la scena "in exactly the style, lighting, palette and framing" di al massimo due delle tue immagini di condivisione o copertine, usate come riferimento. Senza riferimenti produce una fotografia editoriale sobria, con luce naturale. Il prompt chiede di evitare testo, lettere, numeri, loghi e filigrane, forme astratte su qualsiasi schermo, e di usare laptop, telefoni e monitor semplici e senza marchio.
- La verifica. Un modello di visione (Llama 4 Scout) esamina il risultato. Un'immagine con un logo o con testo leggibile conta come tentativo fallito e viene generata di nuovo in un'esecuzione successiva.
Il passaggio della copertina nel writer non viene mai ritentato da solo. Se fallisce, l'articolo prosegue senza che nulla resti bloccato.
Il file che riceve il tuo sito
| Proprietà | Valore |
|---|---|
| Formato | JPEG |
| Dimensioni | 1536 per 1024 pixel, rapporto 3:2 |
| Indirizzo | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Cache | Pubblica e immutabile per un anno: il nome del file è lo SHA-256 dell'immagine |
Le consegne la includono come article.cover con url, sha256, contentType, width e height. Scaricala una volta e conserva una tua copia: l'immagine appartiene al tuo sito, come il resto dell'articolo. Con l'hosting di AutoPSEO, le copertine vengono servite sotto il percorso del tipo di contenuto, in /_cover/<slug>.jpg, nelle dimensioni e nei formati usati dal tuo template.
Usare un'immagine tua
Un writer che lavora tramite MCP può fornire qualsiasi immagine, realizzata come preferisce (la tua AI):
- Insieme alla bozza: il campo
coverdicontent_submit, conurl(un indirizzo https sul web pubblico, scaricato una sola volta) oppuredata(base64, fino a 2,5 MB). - Come file: una PUT dei byte dell'immagine all'indirizzo
coverUploadUrlchecontent_submitrestituisce quando il tuo sito richiede una copertina. - In un secondo momento:
content_set_covercon un'immagine, oppure senza immagine per ottenere un indirizzo di caricamento. È anche il modo per sostituire la copertina di un articolo pubblicato.
AutoPSEO controlla la tua immagine solo come immagine: PNG, JPEG o WebP, tra 10 KB e 12 MB, larga almeno 800 pixel e alta almeno 400, in formato orizzontale (non più alta che larga, non più larga di 2,5 a 1). Viene ritagliata al centro in 3:2 e salvata come JPEG da 1536 per 1024. La verifica di visione non viene eseguita sulla tua immagine, che viene conservata anche quando AutoPSEO non sa se il tuo sito mostra le copertine: la decisione spetta al tuo sito.
Generare l'immagine dal prompt di AutoPSEO
Un writer dotato di un proprio strumento per le immagini può comunque usare il prompt e le verifiche di AutoPSEO:
- Descrivi una scena da 20 a 600 caratteri e inviala con
content_cover. AutoPSEO la controlla come fa con le proprie scene e restituisce il prompt per l'immagine, fino a due copertine del tuo sito come riferimenti e un indirizzo di caricamento firmato. - Genera l'immagine da quel prompt con qualsiasi strumento e invia i byte all'indirizzo con una PUT. L'indirizzo funziona per un'ora e accetta fino a cinque immagini.
- AutoPSEO ridimensiona l'immagine a 1536 per 1024, esegue la verifica di visione e la conserva. Un articolo pubblicato viene inviato di nuovo al tuo sito con la nuova copertina.
| Risposta al caricamento | Significato |
|---|---|
| 403 | L'indirizzo non è valido o è scaduto |
| 413 | Supera i 12 MB |
| 415 | Non è un'immagine |
| 422 | La verifica l'ha rifiutata: generala di nuovo e inviala allo stesso indirizzo |
| 429 | L'indirizzo ha già ricevuto cinque immagini: chiedine uno nuovo |
| 409 | Il sito non mostra copertine |
Il runner non presidiato descritto in la tua AI usa questo flusso con il suo strumento make_cover, generando le immagini con la Codex CLI o la Grok CLI sul tuo Mac.