文件
文章封面圖:何時繪製,以及如何檢查
內容引擎何時繪製封面圖、無品牌的場景與圖片如何產生並檢查、你的網站會收到的檔案,以及如何自備圖片。
如果你的網站會在每篇文章旁顯示封面圖,內容引擎會為每篇文章準備一張。AutoPSEO 的寫作器在撰寫文章的同時繪製封面圖,風格會比照你現有的封面圖,並由視覺模型剔除任何含有標誌或可辨識文字的圖片。你自己的 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] 會以最多兩張你自己的分享圖片或封面圖作為參考,「在風格、光線、色調與構圖上完全比照」它們來繪製場景。沒有參考圖時,則繪製一張平靜、採自然光的編輯風格攝影作品。提示詞要求不得出現文字、字母、數字、標誌或浮水印,螢幕上也不得有抽象圖形,並且筆電、手機與螢幕都要是沒有品牌標示的素面款式。
- 檢查。 視覺模型(Llama 4 Scout)會檢視結果。含有標誌或可辨識文字的圖片會被視為一次失敗的嘗試,並在之後的執行中重新繪製。
寫作器的封面圖步驟本身不會自動重試。若失敗,文章會照常繼續,不會因此延誤。
你的網站收到的檔案
| 屬性 | 值 |
|---|---|
| 格式 | 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)。 - 以檔案提供:當你的網站需要封面圖時,將圖片位元組以 PUT 傳送到
content_submit回傳的coverUploadUrl。 - 事後補上:使用
content_set_cover並附上圖片,或不附圖片以取得上傳位址。已上線文章的封面圖也是以這種方式替換。
AutoPSEO 只會把你的圖片當作圖片來檢查:格式為 PNG、JPEG 或 WebP,大小介於 10 KB 到 12 MB,寬度至少 800 像素、高度至少 400 像素,且為橫向(高度不超過寬度,寬度不超過高度的 2.5 倍)。圖片會被置中裁切為 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 進行繪製。