Salta al contenuto
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.

Proprietà → Contenuti4 min di lettura

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 con cover: "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 un article.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

  1. 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.
  2. 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.
  3. 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
FormatoJPEG
Dimensioni1536 per 1024 pixel, rapporto 3:2
Indirizzohttps://app.autopseo.com/media/covers/<property>/<sha256>.jpg
CachePubblica 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 cover di content_submit, con url (un indirizzo https sul web pubblico, scaricato una sola volta) oppure data (base64, fino a 2,5 MB).
  • Come file: una PUT dei byte dell'immagine all'indirizzo coverUploadUrl che content_submit restituisce quando il tuo sito richiede una copertina.
  • In un secondo momento: content_set_cover con 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:

  1. 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.
  2. 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.
  3. 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 caricamentoSignificato
403L'indirizzo non è valido o è scaduto
413Supera i 12 MB
415Non è un'immagine
422La verifica l'ha rifiutata: generala di nuovo e inviala allo stesso indirizzo
429L'indirizzo ha già ricevuto cinque immagini: chiedine uno nuovo
409Il 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.

Metti i tuoi contenuti SEO in pilota automatico

Collega Search Console e il tuo sito. AutoPSEO lo analizza e pianifica subito i primi argomenti. Nessuna carta di credito richiesta.