Documentație
Copertele articolelor: când sunt create și cum sunt verificate
Când generează motorul de conținut o copertă, cum sunt create și verificate scena fără branduri și imaginea, fișierul pe care îl primește site-ul tău și cum poți folosi propria imagine.
Dacă site-ul tău afișează o imagine de copertă la fiecare articol, motorul de conținut oferă una fiecărui articol. Writer-ul AutoPSEO desenează coperta în timp ce scrie, în stilul copertelor tale existente, iar un model de viziune elimină orice imagine care conține un logo sau text lizibil. AI-ul tău poate aduce, în schimb, propria imagine. Copertele sunt JPEG-uri de 1536 pe 1024 de pixeli, livrate odată cu articolul, și nu consumă nici cota ta de articole, nici creditele de cercetare.
Când primește un articol o copertă
AutoPSEO desenează copertele doar pentru un site care le afișează:
- Site-ul tău randează articolele prin webhook și a declarat că afișează coperte: răspunsul său la ping conține
covers: truesau a răspuns cel puțin o dată la o livrare cucover: "wanted". Din acel moment, writer-ul AutoPSEO desenează coperta imediat după ce salvează fiecare ciornă, astfel că prima livrare a articolului o conține deja. - Un articol a ajuns fără copertă. Răspunde la acea livrare cu
cover: "wanted": programul la cinci minute desenează una, începând cu cea mai veche cerere, și ți-o trimite într-unarticle.updated. - AutoPSEO găzduiește articolele, iar șablonul învățat de pe site-ul tău afișează coperte (găzduire).
Un site care nu afișează coperte nu primește niciuna. Programul la cinci minute renunță la un articol după trei încercări eșuate. Un articol publicat își păstrează coperta până când cineva o înlocuiește cu content_set_cover; o revizuire aflată în așteptarea aprobării nu o modifică niciodată.
Cum se desenează o copertă
- Scena. Un model de text din Workers AI (Llama 3.3) descrie pentru articol o singură scenă de cel mult 45 de cuvinte: oameni generici, locul, ce fac, obiectele din jur. Nu menționează nicio companie, marcă, produs, aplicație, site, școală, persoană sau loc și nu pune nimic lizibil în imagine. O scenă care îți numește totuși brandul este respinsă. Modelul de imagine nu vede niciodată articolul în sine.
- Imaginea. FLUX.2 [klein] desenează scena „exact în stilul, lumina, paleta și încadrarea” a până la două dintre propriile tale imagini de partajare sau coperte, folosite ca referințe. Fără referințe, desenează o fotografie editorială calmă, în lumină naturală. Promptul cere să nu existe text, litere, cifre, logo-uri sau filigrane, nici forme abstracte pe ecrane, iar laptopurile, telefoanele și monitoarele să fie simple, fără marcă.
- Verificarea. Un model de viziune (Llama 4 Scout) examinează rezultatul. O imagine cu logo sau text lizibil se numără ca încercare eșuată și este desenată din nou la o rulare ulterioară.
Pasul de copertă al writer-ului nu este reluat niciodată de la sine. Dacă eșuează, articolul merge mai departe fără să blocheze nimic.
Fișierul pe care îl primește site-ul tău
| Proprietate | Valoare |
|---|---|
| Format | JPEG |
| Dimensiune | 1536 pe 1024 de pixeli, raport 3:2 |
| Adresă | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Cache | Public și imutabil timp de un an: numele fișierului este SHA-256 al imaginii |
Livrările o transportă ca article.cover, cu url, sha256, contentType, width și height. Descarc-o o singură dată și păstrează-ți propria copie; site-ul tău deține imaginea, ca restul articolului. Pe găzduirea AutoPSEO, copertele sunt servite sub calea tipului de conținut, la /_cover/<slug>.jpg, în dimensiunile și formatele folosite de șablonul tău.
Folosește propria imagine
Un writer care lucrează prin MCP poate furniza orice imagine dorește, creată în orice fel (propriul tău AI):
- Odată cu ciorna: câmpul
coverdincontent_submit, fieurl(o adresă https de pe web-ul public, descărcată o singură dată), fiedata(base64, până la 2,5 MB). - Ca fișier: un PUT cu octeții imaginii la
coverUploadUrl, pe carecontent_submitîl returnează atunci când site-ul tău dorește o copertă. - Ulterior:
content_set_covercu o imagine sau fără, pentru a primi o adresă de încărcare. Tot așa se înlocuiește coperta unui articol publicat.
AutoPSEO verifică imaginea ta doar ca imagine: PNG, JPEG sau WebP, între 10 KB și 12 MB, de cel puțin 800 de pixeli lățime și 400 înălțime, în format peisaj (nu mai înaltă decât lată și nu mai lată de 2,5 la 1). Este decupată central la 3:2 și salvată ca JPEG de 1536 pe 1024. Verificarea de viziune nu rulează pe imaginea ta, iar imaginea este păstrată chiar și când AutoPSEO nu știe dacă site-ul tău afișează coperte: decide site-ul tău.
Desenează pornind de la promptul AutoPSEO
Un writer care are propriul instrument de imagini poate totuși folosi promptul și verificările AutoPSEO:
- Descrie o scenă de 20 până la 600 de caractere și trimite-o cu
content_cover. AutoPSEO o verifică la fel ca scenele proprii și returnează promptul de imagine, până la două dintre copertele site-ului tău ca referințe și o adresă de încărcare semnată. - Desenează imaginea pornind de la acel prompt, cu orice instrument de imagini, și trimite octeții printr-un PUT la adresă. Adresa este valabilă o oră și acceptă până la cinci imagini.
- AutoPSEO redimensionează imaginea la 1536 pe 1024, rulează verificarea de viziune și o păstrează. Un articol publicat este trimis din nou site-ului tău, cu noua copertă.
| Răspuns la încărcare | Semnificație |
|---|---|
| 403 | Adresa este invalidă sau a expirat |
| 413 | Peste 12 MB |
| 415 | Nu este o imagine |
| 422 | Verificarea a respins-o: desen-o din nou și trimite-o la aceeași adresă |
| 429 | Adresa a primit deja cinci imagini; cere una nouă |
| 409 | Site-ul nu afișează coperte |
Runner-ul nesupravegheat descris la propriul tău AI folosește acest flux cu instrumentul său make_cover, desenând cu Codex CLI sau Grok CLI pe Mac-ul tău.