Документація
Обкладинки статей: коли їх створюють і як перевіряють
Коли контент-рушій створює обкладинку, як формуються сцена та зображення без бренду, як вони перевіряються, який файл отримує ваш сайт і як додати власне зображення.
Якщо ваш сайт показує обкладинку до кожної статті, контент-рушій створює її для кожної статті. Автор AutoPSEO малює обкладинку під час написання тексту в стилі ваших наявних обкладинок, а модель комп'ютерного зору відкидає будь-яке зображення з логотипом або читабельним текстом. Ваш власний ШІ може натомість додати власне зображення. Обкладинки — це JPEG-файли розміром 1536 на 1024 пікселі, які доставляються разом зі статтею і не витрачають ні ліміт статей, ні кредити на дослідження.
Коли стаття отримує обкладинку
AutoPSEO створює обкладинки лише для сайту, який їх показує:
- Ваш сайт сам відображає статті через вебхук і повідомив, що показує обкладинки: у відповіді на пінг є
covers: true, або принаймні раз на доставку він відповівcover: "wanted". Відтоді автор AutoPSEO малює обкладинку одразу після збереження кожної чернетки, тож уже перша доставка статті містить її. - Стаття надійшла без обкладинки. Дайте на цю доставку відповідь
cover: "wanted": розклад із п'ятихвилинним інтервалом створить обкладинку, спочатку обробляючи найстаріші запити, і надішле її вам вarticle.updated. - AutoPSEO розміщує статті сам, а шаблон, який він вивчив на вашому сайті, показує обкладинки (хостинг).
Сайт, що не показує обкладинок, їх не отримує. П'ятихвилинний розклад припиняє спроби для статті після трьох невдалих. Опублікована стаття зберігає свою обкладинку, доки хтось не замінить її через content_set_cover; ревізія, що чекає на перевірку, обкладинку ніколи не змінює.
Як створюється обкладинка
- Сцена. Текстова модель на Workers AI (Llama 3.3) описує для статті одну сцену не довше 45 слів: узагальнені люди, місце, їхні дії, предмети навколо. Вона не називає жодної компанії, бренду, продукту, застосунку, вебсайту, школи, людини чи місця й не розміщує на зображенні нічого читабельного. Сцену, у якій усе ще згадується ваш бренд, відхиляють. Саму статтю модель зображень ніколи не бачить.
- Зображення. FLUX.2 [klein] малює сцену «в точно такому самому стилі, з таким самим освітленням, палітрою та кадруванням», як до двох ваших власних зображень для поширення або обкладинок, що використовуються як референси. Без референсів вона малює спокійну редакційну фотографію при природному світлі. У запиті наказано не додавати тексту, літер, цифр, логотипів і водяних знаків, абстрактних форм на екранах, а також використовувати прості ноутбуки, телефони й монітори без брендів.
- Перевірка. Модель комп'ютерного зору (Llama 4 Scout) розглядає результат. Зображення з логотипом або читабельним текстом вважається невдалою спробою і малюється знову під час наступного запуску.
Крок створення обкладинки в автора ніколи не повторюється сам. Якщо він завершується невдачею, стаття продовжує обробку без затримок.
Файл, який отримує ваш сайт
| Властивість | Значення |
|---|---|
| Формат | JPEG |
| Розмір | 1536 на 1024 пікселі, співвідношення 3:2 |
| Адреса | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Кешування | Публічне й незмінне протягом року: назва файлу — це SHA-256 зображення |
У доставках файл подається як article.cover з полями url, sha256, contentType, width і height. Завантажте його один раз і збережіть власну копію: зображення належить вашому сайту, як і решта статті. На хостингу AutoPSEO обкладинки віддаються за шляхом типу контенту як /_cover/<slug>.jpg у розмірах і форматах, які використовує ваш шаблон.
Додайте власне зображення
Автор, що працює через MCP, може надати будь-яке зображення, створене будь-яким способом (ваш власний ШІ):
- Разом із чернеткою: параметр
coverуcontent_submit— абоurl(https-адреса в публічному вебі, завантажується один раз), абоdata(base64, до 2,5 МБ). - Як файл: PUT із байтами зображення на
coverUploadUrl, якийcontent_submitповертає, коли вашому сайту потрібна обкладинка. - Пізніше:
content_set_coverіз зображенням або без нього, щоб отримати адресу для завантаження. Саме так замінюють обкладинку опублікованої статті.
AutoPSEO перевіряє ваше зображення лише як картинку: PNG, JPEG або WebP, від 10 КБ до 12 МБ, щонайменше 800 пікселів завширшки і 400 заввишки, альбомної орієнтації (не вище, ніж завширшки, і не ширше за співвідношення 2,5 до 1). Його обрізають по центру до 3:2 і зберігають як JPEG 1536 на 1024. Перевірка моделлю комп'ютерного зору для вашого власного зображення не виконується, і воно зберігається навіть тоді, коли AutoPSEO не знає, чи показує ваш сайт обкладинки: рішення за вашим сайтом.
Малювання за запитом AutoPSEO
Автор із власним інструментом для зображень усе одно може скористатися запитом і перевірками AutoPSEO:
- Опишіть сцену довжиною від 20 до 600 символів і надішліть її через
content_cover. AutoPSEO перевіряє її так само, як власні сцени, і повертає запит для зображення, до двох обкладинок вашого сайту як референси та підписану адресу для завантаження. - Намалюйте зображення за цим запитом будь-яким інструментом і надішліть байти методом PUT на цю адресу. Вона діє одну годину й приймає до п'яти зображень.
- AutoPSEO змінює розмір зображення до 1536 на 1024, виконує перевірку моделлю комп'ютерного зору й зберігає його. Опублікована стаття повторно надсилається на ваш сайт із новою обкладинкою.
| Відповідь на завантаження | Значення |
|---|---|
| 403 | Адреса недійсна або термін її дії минув |
| 413 | Понад 12 МБ |
| 415 | Не зображення |
| 422 | Перевірка його відхилила: намалюйте знову й надішліть на ту саму адресу |
| 429 | На адресу вже надійшло п'ять зображень; попросіть нову |
| 409 | Сайт не показує обкладинок |
Автономний виконавець, описаний у розділі ваш власний ШІ, використовує цей процес зі своїм інструментом make_cover і малює за допомогою Codex CLI або Grok CLI на вашому власному Mac.