文档
文章封面图:何时生成,以及如何检查
内容引擎何时生成封面图,如何生成并检查不含品牌的场景与画面,你的网站会收到什么文件,以及如何使用自己的图片。
如果你的网站会在每篇文章中展示封面图,内容引擎会为每篇文章都配上一张。AutoPSEO 的写作器在撰写文章的同时,按照你现有封面的风格绘制封面,并由视觉模型剔除任何带有 logo 或可辨认文字的画面。你也可以让自己的 AI 提供图片。封面是 1536 x 1024 像素的 JPEG,随文章一并交付,不占用你的文章额度和研究点数。
文章何时会有封面
AutoPSEO 只为展示封面的网站生成封面:
- 你的网站通过 webhook 渲染文章,并已声明会展示封面:它对 ping 的应答中带有
covers: true,或者至少有一次在响应交付时返回了cover: "wanted"。此后,AutoPSEO 的写作器会在保存每篇草稿后立即绘制封面,因此文章的首次交付就已包含封面。 - 文章送达时没有封面。 在响应该次交付时返回
cover: "wanted":每五分钟一次的定时任务会按请求时间从早到晚依次生成封面,并通过article.updated发送给你。 - 文章由 AutoPSEO 托管,且它从你的网站学到的模板会展示封面(参见托管)。
不展示封面的网站不会生成封面。某篇文章连续三次尝试失败后,五分钟定时任务就会放弃它。已发布文章的封面会一直保留,直到有人用 content_set_cover 替换;等待审核的修订版不会更改封面。
封面如何生成
- 场景。 Workers AI 上的文本模型(Llama 3.3)为文章描述一个不超过 45 个单词的场景:泛化的人物、地点、他们在做什么,以及周围的物品。场景中不出现任何公司、品牌、产品、应用、网站、学校、人物或地点的名称,画面中也不含任何可读内容。仍然带有你品牌名称的场景会被拒绝。图像模型从不接触文章本身。
- 画面。 FLUX.2 [klein] 以你自己的最多两张分享图或封面图作为参考,按其"完全一致的风格、光线、色调和构图"绘制该场景。没有参考图时,它会绘制一张平静、自然光的编辑风格照片。提示词要求画面中不得出现文字、字母、数字、logo 或水印,屏幕上不得出现抽象图形,笔记本电脑、手机和显示器须为无品牌标识的普通款式。
- 检查。 视觉模型(Llama 4 Scout)会查看生成结果。带有 logo 或可辨认文字的画面算作一次失败尝试,并在之后的运行中重新绘制。
写作器的封面步骤本身不会自动重试。如果失败,文章会继续处理,不会因此被卡住。
你的网站收到的文件
| 属性 | 值 |
|---|---|
| 格式 | JPEG |
| 尺寸 | 1536 x 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 工作的写作器可以提供任意图片,制作方式不限(参见你自己的 AI):
- 随草稿提交:使用
content_submit的cover,可以是url(公共网络上的 https 地址,只获取一次),也可以是data(base64,最大 2.5 MB)。 - 作为文件上传:当你的网站需要封面时,
content_submit会返回coverUploadUrl,向该地址 PUT 图片字节即可。 - 事后设置:使用
content_set_cover并附上图片;不附图片则会得到一个上传地址。已发布文章的封面也通过这种方式替换。
AutoPSEO 只把你的图片当作图片来检查:格式为 PNG、JPEG 或 WebP,大小在 10 KB 到 12 MB 之间,宽度至少 800 像素、高度至少 400 像素,且为横向(高度不超过宽度,宽高比不超过 2.5 比 1)。图片会按 3:2 居中裁剪,并保存为 1536 x 1024 的 JPEG。视觉检查不会对你自己的图片运行;即使 AutoPSEO 不确定你的网站是否展示封面,也会保留这张图片:由你的网站决定。
使用 AutoPSEO 的提示词绘制
拥有自己图像工具的写作器,仍然可以使用 AutoPSEO 的提示词和检查:
- 写一段 20 到 600 个字符的场景描述,并通过
content_cover发送。AutoPSEO 会像检查自己的场景一样检查它,并返回图像提示词、最多两张你网站的封面作为参考图,以及一个带签名的上传地址。 - 用任意图像工具根据该提示词绘制图片,然后将图片字节 PUT 到该地址。该地址有效期为一小时,最多可接收五张图片。
- AutoPSEO 会将图片调整为 1536 x 1024,运行视觉检查并保存。已发布的文章会带着新封面再次发送到你的网站。
| 上传响应 | 含义 |
|---|---|
| 403 | 地址无效或已过期 |
| 413 | 超过 12 MB |
| 415 | 不是图片 |
| 422 | 未通过检查:请重新绘制并发送到同一地址 |
| 429 | 该地址已接收五张图片;请申请新的地址 |
| 409 | 该网站不展示封面 |
你自己的 AI 中介绍的无人值守运行器,通过其 make_cover 工具使用这一流程,并在你自己的 Mac 上使用 Codex CLI 或 Grok CLI 绘制图片。