コンテンツへスキップ
ドキュメント

記事カバー画像:描画されるタイミングと検証の仕組み

コンテンツエンジンがカバー画像を描画するタイミング、ブランド要素を含まないシーンと画像の生成・検証方法、サイトに届くファイル、独自の画像を使う方法を説明します。

プロパティ → コンテンツ読了まで1分

サイトが記事ごとにカバー画像を表示する場合、コンテンツエンジンはすべての記事にカバー画像を用意します。AutoPSEO のライターは、記事を書く際に既存のカバー画像のスタイルに合わせてカバーを描画します。ロゴや読み取れる文字が含まれる画像は、ビジョンモデルがすべて破棄します。独自の AI から画像を持ち込むこともできます。カバー画像は 1536 x 1024 ピクセルの JPEG で、記事とともに配信されます。記事の利用枠やリサーチクレジットは消費しません。

記事にカバー画像が付くタイミング

AutoPSEO がカバー画像を描画するのは、カバーを表示するサイトだけです。

  • サイトがwebhook経由で記事を表示しており、カバーを表示すると伝えている場合:ping への応答に covers: true が含まれているか、配信への応答で cover: "wanted" を一度でも返したことがある場合が該当します。以降、AutoPSEO のライターは下書きを保存した直後にカバーを描画するため、記事の最初の配信からカバーが付きます。
  • カバーなしで記事が届いた場合:その配信に cover: "wanted" で応答してください。5 分ごとのスケジュールで、リクエストが古いものから順にカバーが描画され、article.updated として送信されます。
  • AutoPSEO が記事をホストしており、サイトから学習したテンプレートがカバーを表示する場合(ホスティング)。

カバーを表示しないサイトには、カバーは付きません。5 分ごとのスケジュールは、3 回失敗した記事の処理を打ち切ります。公開中の記事のカバーは、content_set_cover で差し替えるまで変わりません。レビュー待ちのリビジョンによって変更されることもありません。

カバー画像の描画方法

  1. シーン。 Workers AI 上のテキストモデル(Llama 3.3)が、記事に合わせて 45 語以内のシーンを 1 つ記述します。内容は、特定されない人物、場所、行動、周囲の物です。企業、ブランド、製品、アプリ、ウェブサイト、学校、人物、場所の名前は一切出さず、画像内に読み取れる文字も入れません。ブランド名が残っているシーンは却下されます。画像モデルが記事そのものを見ることはありません。
  2. 画像。 FLUX.2 [klein] が、サイト自身のシェア画像またはカバー画像(最大 2 枚)を参照として、「exactly the style, lighting, palette and framing」でシーンを描画します。参照がない場合は、自然光の落ち着いたエディトリアル写真風に描きます。プロンプトでは、テキスト、文字、数字、ロゴ、透かし、画面上の抽象的な図形を禁止し、ノートパソコン、スマートフォン、モニターはブランドの入っていない無地のものにするよう指示します。
  3. 検証。 ビジョンモデル(Llama 4 Scout)が結果を確認します。ロゴや読み取れる文字が含まれる画像は失敗として扱われ、後の実行で描き直されます。

ライターのカバー生成ステップは、単独で再試行されることはありません。失敗した場合は、記事の処理を止めることなく、カバーなしで進みます。

サイトに届くファイル

プロパティ値
形式JPEG
サイズ1536 x 1024 ピクセル(3:2)
アドレスhttps://app.autopseo.com/media/covers/<property>/<sha256>.jpg
キャッシュpublic かつ immutable で 1 年間有効。ファイル名は画像の SHA-256

配信では、url、sha256、contentType、width、height を持つ article.cover としてカバーが届きます。一度取得して、自分のコピーを保持してください。この画像は、記事のほかの部分と同様にサイト側が所有します。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 倍以内)であることが条件です。画像は中央を基準に 3:2 へクロップされ、1536 x 1024 の JPEG として保存されます。独自の画像にはビジョンチェックは実行されません。また、サイトがカバーを表示するかどうか AutoPSEO が把握していない場合でも、画像は保持されます。判断はサイトに委ねられます。

AutoPSEO のプロンプトで描画する

独自の画像生成ツールを持つライターでも、AutoPSEO のプロンプトとチェックを利用できます。

  1. 20 文字から 600 文字のシーンを記述し、content_cover で送信します。AutoPSEO は、自社で生成するシーンと同じ基準でチェックし、画像プロンプト、参照用としてサイトのカバー画像(最大 2 枚)、署名付きのアップロード用アドレスを返します。
  2. そのプロンプトを使って任意の画像ツールで描画し、バイト列をアドレスに PUT します。このアドレスの有効期間は 1 時間で、最大 5 枚まで受け付けます。
  3. AutoPSEO が画像を 1536 x 1024 にリサイズし、ビジョンチェックを実行したうえで保持します。公開中の記事は、新しいカバー付きでサイトに再送信されます。
アップロードの応答意味
403アドレスが無効、または期限切れです
41312 MB を超えています
415画像ではありません
422チェックで却下されました。描き直して同じアドレスに送信してください
429アドレスが 5 枚の画像を受け付け済みです。新しいアドレスをリクエストしてください
409サイトがカバーを表示しません

独自の AIで説明している無人ランナーは、make_cover ツールでこのフローを利用します。描画には、お使いの Mac 上の Codex CLI または Grok CLI を使用します。

SEOコンテンツを自動運転に

Search Consoleとサイトを接続してください。AutoPSEOがサイトをスキャンし、最初のトピックをすぐに計画します。クレジットカードは不要です。