Документация
Обложки статей: когда они создаются и как проверяются
Когда движок контента создаёт обложку, как формируются и проверяются сцена без упоминаний бренда и изображение, какой файл получает ваш сайт и как загрузить собственное изображение.
Если ваш сайт показывает обложку у каждой статьи, движок контента создаёт её для каждой статьи. Автор AutoPSEO рисует обложку во время написания текста в стиле ваших существующих обложек, а модель компьютерного зрения отбрасывает любое изображение с логотипом или читаемым текстом. Ваш собственный ИИ может вместо этого принести своё изображение. Обложки — это JPEG размером 1536 на 1024 пикселя, они доставляются вместе со статьёй и не расходуют ни лимит статей, ни кредиты на исследования.
Когда статья получает обложку
AutoPSEO рисует обложки только для сайта, который их показывает:
- Ваш сайт сам отображает статьи через вебхук и сообщил, что показывает обложки: в ответе на ping есть
covers: true, или он хотя бы раз ответил на доставкуcover: "wanted". После этого автор AutoPSEO рисует обложку сразу после сохранения каждого черновика, так что уже первая доставка статьи содержит обложку. - Статья пришла без обложки. Ответьте на эту доставку
cover: "wanted": расписание с интервалом в пять минут нарисует обложку, начиная с самого старого запроса, и отправит её вам вarticle.updated. - AutoPSEO размещает статьи сам, и шаблон, изученный на вашем сайте, показывает обложки (хостинг).
Сайт, который не показывает обложки, их не получает. Расписание с интервалом в пять минут отказывается от статьи после трёх неудачных попыток. Опубликованная статья сохраняет свою обложку, пока кто-нибудь не заменит её через content_set_cover; ревизия, ожидающая проверки, обложку никогда не меняет.
Как рисуется обложка
- Сцена. Текстовая модель на Workers AI (Llama 3.3) описывает для статьи одну сцену не длиннее 45 слов: обобщённые люди, место, их действия, предметы вокруг. В ней не называются ни компания, ни бренд, ни продукт, ни приложение, ни сайт, ни школа, ни человек, ни место, и в изображении нет ничего читаемого. Сцена, в которой всё ещё упоминается ваш бренд, отклоняется. Сам текст статьи модель изображений не видит.
- Изображение. FLUX.2 [klein] рисует сцену «точно в том же стиле, с тем же освещением, палитрой и композицией», что и до двух ваших собственных изображений для соцсетей или обложек, используемых как образцы. Без образцов модель рисует спокойную editorial-фотографию при естественном свете. В запросе указано: никакого текста, букв, цифр, логотипов и водяных знаков, никаких абстрактных фигур на экранах, ноутбуки, телефоны и мониторы — простые, без брендов.
- Проверка. Модель компьютерного зрения (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.