콘텐츠로 건너뛰기
문서

기사 커버: 생성 시점과 검수 방식

콘텐츠 엔진이 커버를 생성하는 시점, 브랜드가 없는 장면과 이미지가 만들어지고 검수되는 방식, 사이트가 받는 파일, 직접 준비한 이미지를 사용하는 방법을 설명합니다.

속성 → 콘텐츠3분 소요

사이트에서 기사마다 커버 이미지를 보여 준다면, 콘텐츠 엔진은 모든 기사에 커버를 만들어 줍니다. AutoPSEO의 라이터는 기사를 작성하는 동안 기존 커버의 스타일에 맞춰 커버를 그리고, 비전 모델이 로고나 읽을 수 있는 텍스트가 들어간 이미지를 걸러냅니다. 직접 운영하는 AI가 자체 이미지를 가져올 수도 있습니다. 커버는 1536 x 1024 픽셀 JPEG이며 기사와 함께 전달되고, 기사 허용량이나 리서치 크레딧은 사용하지 않습니다.

기사에 커버가 만들어지는 경우

AutoPSEO는 커버를 보여 주는 사이트에만 커버를 만듭니다.

  • 사이트가 웹훅으로 기사를 렌더링하고, 커버를 보여 준다고 알린 경우입니다. ping 응답에 covers: true가 포함되어 있거나, 전달에 대해 cover: "wanted"로 한 번 이상 응답한 적이 있어야 합니다. 이후에는 AutoPSEO의 라이터가 초안을 저장한 직후 커버를 그리므로, 기사의 첫 번째 전달에 이미 커버가 포함됩니다.
  • 커버 없이 기사가 도착한 경우입니다. 해당 전달에 cover: "wanted"로 응답하세요. 5분마다 실행되는 스케줄이 요청이 오래된 순서대로 커버를 그려 article.updated로 보내 드립니다.
  • AutoPSEO가 기사를 호스팅하고, 사이트에서 학습한 템플릿이 커버를 보여 주는 경우입니다(호스팅).

커버를 보여 주지 않는 사이트에는 커버가 만들어지지 않습니다. 5분 스케줄은 한 기사에 대해 세 번 실패하면 시도를 중단합니다. 게시된 기사의 커버는 content_set_cover로 교체하기 전까지 그대로 유지되며, 검토를 기다리는 수정본이 커버를 바꾸는 일은 없습니다.

커버가 그려지는 과정

  1. 장면. Workers AI의 텍스트 모델(Llama 3.3)이 기사에 맞는 장면을 45단어 이내로 묘사합니다. 불특정한 인물, 장소, 하는 일, 주변 사물로 구성하며, 회사, 브랜드, 제품, 앱, 웹사이트, 학교, 인물, 장소의 이름은 쓰지 않고 이미지 안에 읽을 수 있는 내용도 넣지 않습니다. 브랜드 이름이 남아 있는 장면은 거부됩니다. 이미지 모델은 기사 본문을 보지 못합니다.
  2. 이미지. FLUX.2 [klein]이 사이트의 공유 이미지나 커버 중 최대 두 개를 참조로 삼아 "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
캐싱1년간 public, immutable: 파일 이름이 이미지의 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배를 넘지 않아야 함). 이미지는 3:2로 중앙 크롭된 뒤 1536 x 1024 JPEG로 저장됩니다. 직접 준비한 이미지에는 비전 검수를 실행하지 않으며, AutoPSEO가 사이트의 커버 표시 여부를 알지 못하는 경우에도 이미지는 보관됩니다. 표시 여부는 사이트가 결정하기 때문입니다.

AutoPSEO의 프롬프트로 그리기

자체 이미지 도구가 있는 라이터도 AutoPSEO의 프롬프트와 검수를 그대로 활용할 수 있습니다.

  1. 20자에서 600자 사이로 장면을 묘사해 content_cover로 보냅니다. AutoPSEO는 자체 장면과 같은 기준으로 이를 검사한 뒤, 이미지 프롬프트와 사이트 커버 최대 두 개(참조용), 서명된 업로드 주소를 반환합니다.
  2. 그 프롬프트로 원하는 이미지 도구를 사용해 그림을 그리고, 바이트를 해당 주소로 PUT합니다. 이 주소는 1시간 동안 유효하며 최대 다섯 장까지 받을 수 있습니다.
  3. AutoPSEO가 이미지를 1536 x 1024로 조정하고 비전 검수를 거쳐 보관합니다. 게시된 기사는 새 커버와 함께 사이트로 다시 전송됩니다.
업로드 응답의미
403주소가 올바르지 않거나 만료됨
41312 MB 초과
415이미지가 아님
422검수에서 거부됨: 다시 그려 같은 주소로 보내세요
429주소가 이미 다섯 장을 받음: 새 주소를 요청하세요
409사이트가 커버를 보여 주지 않음

직접 운영하는 AI에서 설명하는 무인 러너는 make_cover 도구로 이 흐름을 사용하며, 사용자의 Mac에서 Codex CLI 또는 Grok CLI로 그림을 그립니다.

SEO 콘텐츠를 자동 운영으로

Search Console과 사이트를 연결하세요. AutoPSEO가 사이트를 스캔하고 첫 주제를 바로 기획합니다. 신용카드는 필요 없습니다.