Dokumentace
Obálky článků: kdy se kreslí a jak se kontrolují
Kdy content engine nakreslí obálku, jak vzniká scéna bez značek a samotný obrázek, jak se kontrolují, jaký soubor váš web obdrží a jak použít vlastní obrázek.
Pokud váš web zobrazuje u každého článku obálku, content engine ji vytvoří ke každému článku. Autor AutoPSEO obálku nakreslí během psaní ve stylu vašich stávajících obálek a vizuální model zahodí každý obrázek s logem nebo čitelným textem. Vaše vlastní AI může místo toho dodat vlastní obrázek. Obálky jsou JPEG soubory o rozměrech 1536 × 1024 pixelů, doručují se spolu s článkem a nečerpají ani váš limit článků, ani kredity na research.
Kdy článek dostane obálku
AutoPSEO kreslí obálky jen pro web, který je zobrazuje:
- Články vykresluje váš web přes webhook a oznámil, že obálky zobrazuje: jeho odpověď na ping obsahuje
covers: true, nebo alespoň jednou odpověděl na doručení hodnotoucover: "wanted". Od té chvíle autor AutoPSEO nakreslí obálku hned po uložení každého konceptu, takže už první doručení článku ji obsahuje. - Článek dorazil bez obálky. Odpovězte na toto doručení hodnotou
cover: "wanted": pětiminutový plánovač jednu nakreslí, nejstarší požadavky první, a pošle vám ji v událostiarticle.updated. - Články hostuje AutoPSEO a šablona, kterou se naučil z vašeho webu, obálky zobrazuje (hosting).
Web, který obálky nezobrazuje, žádné nedostane. Pětiminutový plánovač se po třech neúspěšných pokusech článku vzdá. Publikovaný článek si obálku ponechá, dokud ji někdo nenahradí pomocí content_set_cover; revize čekající na schválení ji nikdy nezmění.
Jak se obálka kreslí
- Scéna. Textový model na Workers AI (Llama 3.3) k článku popíše jednu scénu o nejvýše 45 slovech: obecné postavy, místo, co dělají, předměty kolem nich. Nepojmenuje žádnou firmu, značku, produkt, aplikaci, web, školu, osobu ani místo a do obrázku nedá nic čitelného. Scéna, která stále zmiňuje vaši značku, se odmítne. Obrazový model samotný článek nikdy neuvidí.
- Obrázek. FLUX.2 [klein] nakreslí scénu „přesně ve stylu, osvětlení, paletě a kompozici“ až dvou vašich vlastních sdílených obrázků nebo obálek, které slouží jako reference. Bez referencí nakreslí klidnou redakční fotografii v přirozeném světle. Zadání vyžaduje žádný text, písmena, čísla, loga ani vodoznaky, žádné abstraktní tvary na obrazovkách a obyčejné značkově neoznačené notebooky, telefony a monitory.
- Kontrola. Výsledek prohlédne vizuální model (Llama 4 Scout). Obrázek s logem nebo čitelným textem se počítá jako neúspěšný pokus a při některém z dalších běhů se nakreslí znovu.
Krok obálky u autora se sám od sebe nikdy nezopakuje. Pokud selže, článek pokračuje dál bez zdržení.
Soubor, který váš web obdrží
| Vlastnost | Hodnota |
|---|---|
| Formát | JPEG |
| Rozměry | 1536 × 1024 pixelů, poměr 3:2 |
| Adresa | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Cachování | Veřejné a neměnné po dobu jednoho roku: název souboru je SHA-256 obrázku |
Doručení ji obsahuje jako article.cover s poli url, sha256, contentType, width a height. Stáhněte si ji jednou a uložte si vlastní kopii; obrázek, stejně jako zbytek článku, patří vašemu webu. Na hostingu AutoPSEO se obálky servírují pod cestou daného typu obsahu na adrese /_cover/<slug>.jpg, ve velikostech a formátech, které používá vaše šablona.
Vlastní obrázek
Autor pracující přes MCP může dodat libovolný obrázek vytvořený jakýmkoli způsobem (vlastní AI):
- Spolu s konceptem: parametr
coverucontent_submit, buďurl(adresa https na veřejném webu, stáhne se jednou), nebodata(base64, až 2,5 MB). - Jako soubor: požadavek PUT s bajty obrázku na
coverUploadUrl, kteroucontent_submitvrátí, když váš web obálku chce. - Později:
content_set_covers obrázkem, nebo bez něj, pokud chcete získat adresu pro nahrání. Takto se také nahrazuje obálka publikovaného článku.
AutoPSEO váš obrázek kontroluje jen jako obrázek: PNG, JPEG nebo WebP, od 10 KB do 12 MB, alespoň 800 pixelů na šířku a 400 na výšku, na šířku (ne vyšší než široký, ne širší než 2,5 : 1). Ořízne se na střed do poměru 3:2 a uloží jako JPEG 1536 × 1024. Vizuální kontrola se u vašeho vlastního obrázku nespouští a obrázek se ponechá i tehdy, když AutoPSEO neví, zda váš web obálky zobrazuje: rozhoduje váš web.
Kreslení podle zadání AutoPSEO
Autor, který má vlastní nástroj pro tvorbu obrázků, může i tak využít zadání a kontroly AutoPSEO:
- Popište scénu o 20 až 600 znacích a pošlete ji přes
content_cover. AutoPSEO ji zkontroluje stejně jako své vlastní scény a vrátí zadání pro obrázek, až dvě obálky vašeho webu jako reference a podepsanou adresu pro nahrání. - Nakreslete obrázek podle tohoto zadání libovolným nástrojem a bajty odešlete požadavkem PUT na tuto adresu. Adresa platí jednu hodinu a přijme nejvýše pět obrázků.
- AutoPSEO obrázek zmenší na 1536 × 1024, provede vizuální kontrolu a uloží ho. Publikovaný článek se vašemu webu pošle znovu s novou obálkou.
| Odpověď při nahrávání | Význam |
|---|---|
| 403 | Adresa je neplatná nebo vypršela |
| 413 | Přes 12 MB |
| 415 | Není to obrázek |
| 422 | Kontrola ho odmítla: nakreslete ho znovu a pošlete na stejnou adresu |
| 429 | Adresa už přijala pět obrázků; požádejte o novou |
| 409 | Web obálky nezobrazuje |
Samostatný runner popsaný v části vlastní AI používá tento postup se svým nástrojem make_cover a kreslí pomocí Codex CLI nebo Grok CLI na vašem vlastním Macu.