Dokumentacja
Okładki artykułów: kiedy są tworzone i jak są sprawdzane
Kiedy silnik treści tworzy okładkę, jak powstaje i jest sprawdzana scena bez marek oraz obraz, jaki plik trafia do Twojej witryny i jak dodać własny obraz.
Jeśli Twoja witryna wyświetla okładkę przy każdym artykule, silnik treści tworzy ją dla każdego z nich. Autor AutoPSEO rysuje okładkę w trakcie pisania, w stylu Twoich dotychczasowych okładek, a model wizyjny odrzuca każdy obraz z logo lub czytelnym tekstem. Własna AI może zamiast tego dostarczyć swój obraz. Okładki to pliki JPEG o wymiarach 1536 na 1024 piksele, dostarczane razem z artykułem, a ich tworzenie nie zużywa ani limitu artykułów, ani kredytów badawczych.
Kiedy artykuł dostaje okładkę
AutoPSEO tworzy okładki tylko dla witryny, która je wyświetla:
- Twoja witryna renderuje artykuły przez webhook i zgłosiła, że wyświetla okładki: jej odpowiedź na ping zawiera
covers: truealbo przynajmniej raz odpowiedziała na dostarczenie wartościącover: "wanted". Od tego momentu autor AutoPSEO rysuje okładkę zaraz po zapisaniu każdego szkicu, więc już pierwsze dostarczenie artykułu zawiera okładkę. - Artykuł dotarł bez okładki. Odpowiedz na to dostarczenie wartością
cover: "wanted": harmonogram uruchamiany co pięć minut narysuje okładkę, zaczynając od najstarszego zgłoszenia, i prześle ją do Ciebie w zdarzeniuarticle.updated. - AutoPSEO hostuje artykuły, a szablon, którego nauczyło się z Twojej witryny, wyświetla okładki (hosting).
Witryna, która nie wyświetla okładek, ich nie dostaje. Harmonogram uruchamiany co pięć minut rezygnuje z artykułu po trzech nieudanych próbach. Opublikowany artykuł zachowuje swoją okładkę, dopóki ktoś nie zastąpi jej przez content_set_cover; wersja oczekująca na recenzję nigdy jej nie zmienia.
Jak powstaje okładka
- Scena. Model tekstowy w Workers AI (Llama 3.3) opisuje dla artykułu jedną scenę liczącą najwyżej 45 słów: ogólnie opisani ludzie, miejsce, ich zajęcie, przedmioty wokół. Nie wymienia żadnej firmy, marki, produktu, aplikacji, witryny, szkoły, osoby ani miejsca i nie umieszcza na obrazie niczego, co dałoby się odczytać. Scena, która nadal zawiera nazwę Twojej marki, jest odrzucana. Model obrazu nigdy nie widzi samego artykułu.
- Obraz. FLUX.2 [klein] rysuje scenę „dokładnie w stylu, oświetleniu, palecie barw i kadrowaniu" maksymalnie dwóch Twoich własnych obrazów udostępnianych lub okładek, używanych jako wzorce. Bez wzorców tworzy spokojną, redakcyjną fotografię przy naturalnym świetle. Prompt wyklucza tekst, litery, cyfry, logo i znaki wodne, abstrakcyjne kształty na ekranach oraz wymaga zwykłych laptopów, telefonów i monitorów bez oznaczeń marki.
- Kontrola. Model wizyjny (Llama 4 Scout) ocenia wynik. Obraz z logo lub czytelnym tekstem jest liczony jako nieudana próba i zostanie narysowany ponownie przy kolejnym uruchomieniu.
Krok okładki w pracy autora nigdy nie jest ponawiany samodzielnie. Jeśli się nie powiedzie, artykuł powstaje dalej i nic się nie blokuje.
Plik, który otrzymuje Twoja witryna
| Właściwość | Wartość |
|---|---|
| Format | JPEG |
| Rozmiar | 1536 na 1024 piksele, proporcje 3:2 |
| Adres | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Pamięć podręczna | Publiczna i niezmienna przez rok: nazwą pliku jest suma SHA-256 obrazu |
Dostarczenia zawierają ją jako article.cover z polami url, sha256, contentType, width i height. Pobierz ją raz i zachowaj własną kopię; obraz należy do Twojej witryny tak samo jak reszta artykułu. W hostingu AutoPSEO okładki są serwowane pod ścieżką typu treści jako /_cover/<slug>.jpg, w rozmiarach i formatach używanych przez Twój szablon.
Własny obraz
Autor pracujący przez MCP może dostarczyć dowolny obraz, wykonany w dowolny sposób (własna AI):
- Razem ze szkicem: pole
coverwcontent_submit, z wartościąurl(adres https w publicznym internecie, pobierany jednorazowo) albodata(base64, do 2,5 MB). - Jako plik: żądanie PUT z bajtami obrazu na adres
coverUploadUrl, którycontent_submitzwraca, gdy Twoja witryna oczekuje okładki. - Później:
content_set_coverz obrazem albo bez niego, aby otrzymać adres do przesłania. W ten sposób zastępuje się też okładkę opublikowanego artykułu.
AutoPSEO sprawdza Twój obraz wyłącznie pod kątem parametrów technicznych: PNG, JPEG lub WebP, od 10 KB do 12 MB, co najmniej 800 pikseli szerokości i 400 wysokości, w orientacji poziomej (nie wyższy niż szeroki, nie szerszy niż 2,5 do 1). Jest on przycinany od środka do proporcji 3:2 i zapisywany jako JPEG 1536 na 1024. Kontrola wizyjna nie jest uruchamiana dla Twojego obrazu, a obraz jest zachowywany nawet wtedy, gdy AutoPSEO nie wie, czy Twoja witryna wyświetla okładki: decyzja należy do Twojej witryny.
Rysowanie na podstawie promptu AutoPSEO
Autor z własnym narzędziem do obrazów nadal może skorzystać z promptu i kontroli AutoPSEO:
- Opisz scenę o długości od 20 do 600 znaków i wyślij ją przez
content_cover. AutoPSEO sprawdza ją tak jak własne sceny i zwraca prompt obrazu, do dwóch okładek Twojej witryny jako wzorce oraz podpisany adres do przesłania. - Narysuj obraz na podstawie tego promptu dowolnym narzędziem i wyślij bajty żądaniem PUT na ten adres. Adres działa przez godzinę i przyjmuje do pięciu obrazów.
- AutoPSEO zmienia rozmiar obrazu do 1536 na 1024, przeprowadza kontrolę wizyjną i zachowuje go. Opublikowany artykuł jest ponownie wysyłany do Twojej witryny z nową okładką.
| Odpowiedź na przesłanie | Znaczenie |
|---|---|
| 403 | Adres jest nieprawidłowy lub wygasł |
| 413 | Ponad 12 MB |
| 415 | To nie jest obraz |
| 422 | Kontrola go odrzuciła: narysuj go ponownie i wyślij na ten sam adres |
| 429 | Adres przyjął już pięć obrazów; poproś o nowy |
| 409 | Witryna nie wyświetla okładek |
Autonomiczny runner opisany w własna AI korzysta z tego przepływu przez swoje narzędzie make_cover, rysując za pomocą Codex CLI lub Grok CLI na Twoim własnym Macu.