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.
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 comcover: "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 umarticle.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
- 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.
- 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.
- 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
| Propriedade | Valor |
|---|---|
| Formato | JPEG |
| Tamanho | 1536 por 1024 pixels, proporção 3:2 |
| Endereço | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| Cache | Pú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
coverdecontent_submit, comurl(um endereço https na web pública, baixado uma única vez) oudata(base64, até 2,5 MB). - Como arquivo: um PUT dos bytes da imagem para o
coverUploadUrlquecontent_submitretorna quando o seu site quer uma capa. - Depois:
content_set_covercom 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:
- 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. - 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.
- 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 envio | Significado |
|---|---|
| 403 | O endereço é inválido ou expirou |
| 413 | Acima de 12 MB |
| 415 | Não é uma imagem |
| 422 | A verificação a recusou: gere-a de novo e envie para o mesmo endereço |
| 429 | O endereço já recebeu cinco imagens; peça um novo |
| 409 | O 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.