Ir para o conteúdo
Documentação

Capas dos artigos: quando são geradas e como são verificadas

Quando o motor de conteúdo gera uma capa, como a cena sem marcas e a imagem são criadas e verificadas, o arquivo que seu site recebe e como usar sua própria imagem.

Propriedade → Conteúdo5 min de leitura

Se o seu site exibe uma imagem de capa em cada artigo, o motor de conteúdo gera uma para todos eles. O redator do AutoPSEO desenha a capa enquanto escreve, no estilo das capas que você já tem, e um modelo de visão descarta qualquer imagem com logotipo ou texto legível. Sua própria IA pode trazer a imagem dela no lugar. As capas são JPEGs de 1536 por 1024 pixels, entregues junto com o artigo, e não consomem a cota de artigos nem os créditos de pesquisa.

Quando um artigo recebe uma capa

O AutoPSEO só gera capas para sites que as exibem:

  • Seu site renderiza os artigos pelo webhook e informou que exibe capas: a resposta ao ping traz covers: true, ou ele respondeu a alguma entrega com cover: "wanted" ao menos uma vez. A partir daí, o redator do AutoPSEO gera a capa logo depois de salvar cada rascunho, de modo que a primeira entrega do artigo já a inclui.
  • Um artigo chegou sem capa. Responda a essa entrega com cover: "wanted": a rotina de cinco minutos gera uma, atendendo primeiro o pedido mais antigo, e a envia a você em um article.updated.
  • O AutoPSEO hospeda os artigos e o template aprendido do seu site exibe capas (hospedagem).

Um site que não exibe capas não recebe nenhuma. A rotina de cinco minutos desiste de um artigo após três tentativas fracassadas. Um artigo publicado mantém a capa até que alguém a substitua com content_set_cover; uma revisão que aguarda aprovação nunca a altera.

Como uma capa é gerada

  1. A cena. Um modelo de texto no Workers AI (Llama 3.3) descreve para o artigo uma cena de no máximo 45 palavras: pessoas genéricas, o local, o que fazem, os objetos ao redor. Ela não cita nenhuma empresa, marca, produto, aplicativo, site, escola, pessoa ou lugar, e não coloca nada legível na imagem. Uma cena que ainda cite a sua marca é recusada. O modelo de imagem nunca vê o artigo em si.
  2. A imagem. O FLUX.2 [klein] desenha a cena "exatamente no estilo, na iluminação, na paleta e no enquadramento" de até duas das suas próprias imagens de compartilhamento ou capas, usadas como referência. Sem referências, ele cria uma fotografia editorial tranquila, com luz natural. O prompt pede que não haja texto, letras, números, logotipos nem marcas d'água, que as telas exibam apenas formas abstratas e que notebooks, celulares e monitores sejam simples e sem marca.
  3. A verificação. Um modelo de visão (Llama 4 Scout) analisa o resultado. Uma imagem com logotipo ou texto legível conta como tentativa fracassada e é gerada novamente em uma execução posterior.

A etapa de capa do redator nunca é repetida por conta própria. Se falhar, o artigo segue sem ela, sem atrasar nada.

O arquivo que seu site recebe

PropriedadeValor
FormatoJPEG
Tamanho1536 por 1024 pixels, proporção 3:2
Endereçohttps://app.autopseo.com/media/covers/<property>/<sha256>.jpg
CachePúblico e imutável por um ano: o nome do arquivo é o SHA-256 da imagem

As entregas trazem a capa como article.cover, com url, sha256, contentType, width e height. Baixe o arquivo uma vez e guarde sua própria cópia; a imagem pertence ao seu site, como o restante do artigo. Na hospedagem do AutoPSEO, as capas são servidas sob o caminho do tipo de conteúdo, em /_cover/<slug>.jpg, nos tamanhos e formatos que o seu template usa.

Use sua própria imagem

Um redator que trabalha via MCP pode enviar qualquer imagem, criada como preferir (sua própria IA):

  • Junto com o rascunho: o campo cover de content_submit, com url (um endereço https na web pública, baixado uma única vez) ou data (base64, até 2,5 MB).
  • Como arquivo: um PUT dos bytes da imagem para o coverUploadUrl que content_submit retorna quando o seu site quer uma capa.
  • Depois: content_set_cover com uma imagem ou sem nenhuma, para obter um endereço de envio. É também assim que se substitui a capa de um artigo publicado.

O AutoPSEO verifica sua imagem apenas como imagem: PNG, JPEG ou WebP, entre 10 KB e 12 MB, com ao menos 800 pixels de largura e 400 de altura, em formato paisagem (não mais alta que larga, nem mais larga que 2,5 para 1). Ela é recortada ao centro na proporção 3:2 e salva como JPEG de 1536 por 1024. A verificação por visão não é aplicada à sua imagem, e ela é mantida mesmo quando o AutoPSEO não sabe se o seu site exibe capas: quem decide é o seu site.

Gere a imagem a partir do prompt do AutoPSEO

Um redator com sua própria ferramenta de imagem ainda pode usar o prompt e as verificações do AutoPSEO:

  1. Descreva uma cena de 20 a 600 caracteres e envie com content_cover. O AutoPSEO a verifica como faz com as suas próprias cenas e devolve o prompt da imagem, até duas capas do seu site como referência e um endereço de envio assinado.
  2. Gere a imagem a partir desse prompt com qualquer ferramenta e faça um PUT dos bytes para o endereço. Ele funciona por uma hora e aceita até cinco imagens.
  3. O AutoPSEO redimensiona a imagem para 1536 por 1024, executa a verificação por visão e a guarda. Um artigo publicado é enviado novamente ao seu site com a nova capa.
Resposta do envioSignificado
403O endereço é inválido ou expirou
413Acima de 12 MB
415Não é uma imagem
422A verificação a recusou: gere-a de novo e envie para o mesmo endereço
429O endereço já recebeu cinco imagens; peça um novo
409O site não exibe capas

O executor autônomo descrito em sua própria IA usa esse fluxo com a ferramenta make_cover, gerando as imagens com o Codex CLI ou o Grok CLI no seu próprio Mac.

Coloque o seu conteúdo de SEO no piloto automático

Conecte o Search Console e o seu site. O AutoPSEO analisa tudo e planeja os primeiros temas na hora. Sem cartão de crédito.