ドキュメント
記事カバー画像:描画されるタイミングと検証の仕組み
コンテンツエンジンがカバー画像を描画するタイミング、ブランド要素を含まないシーンと画像の生成・検証方法、サイトに届くファイル、独自の画像を使う方法を説明します。
サイトが記事ごとにカバー画像を表示する場合、コンテンツエンジンはすべての記事にカバー画像を用意します。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 で差し替えるまで変わりません。レビュー待ちのリビジョンによって変更されることもありません。
カバー画像の描画方法
- シーン。 Workers AI 上のテキストモデル(Llama 3.3)が、記事に合わせて 45 語以内のシーンを 1 つ記述します。内容は、特定されない人物、場所、行動、周囲の物です。企業、ブランド、製品、アプリ、ウェブサイト、学校、人物、場所の名前は一切出さず、画像内に読み取れる文字も入れません。ブランド名が残っているシーンは却下されます。画像モデルが記事そのものを見ることはありません。
- 画像。 FLUX.2 [klein] が、サイト自身のシェア画像またはカバー画像(最大 2 枚)を参照として、「exactly the style, lighting, palette and framing」でシーンを描画します。参照がない場合は、自然光の落ち着いたエディトリアル写真風に描きます。プロンプトでは、テキスト、文字、数字、ロゴ、透かし、画面上の抽象的な図形を禁止し、ノートパソコン、スマートフォン、モニターはブランドの入っていない無地のものにするよう指示します。
- 検証。 ビジョンモデル(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 のプロンプトとチェックを利用できます。
- 20 文字から 600 文字のシーンを記述し、
content_coverで送信します。AutoPSEO は、自社で生成するシーンと同じ基準でチェックし、画像プロンプト、参照用としてサイトのカバー画像(最大 2 枚)、署名付きのアップロード用アドレスを返します。 - そのプロンプトを使って任意の画像ツールで描画し、バイト列をアドレスに PUT します。このアドレスの有効期間は 1 時間で、最大 5 枚まで受け付けます。
- AutoPSEO が画像を 1536 x 1024 にリサイズし、ビジョンチェックを実行したうえで保持します。公開中の記事は、新しいカバー付きでサイトに再送信されます。
| アップロードの応答 | 意味 |
|---|---|
| 403 | アドレスが無効、または期限切れです |
| 413 | 12 MB を超えています |
| 415 | 画像ではありません |
| 422 | チェックで却下されました。描き直して同じアドレスに送信してください |
| 429 | アドレスが 5 枚の画像を受け付け済みです。新しいアドレスをリクエストしてください |
| 409 | サイトがカバーを表示しません |
独自の AIで説明している無人ランナーは、make_cover ツールでこのフローを利用します。描画には、お使いの Mac 上の Codex CLI または Grok CLI を使用します。