Saltar al contenido
Documentación

Portadas de artículos: cuándo se dibujan y cómo se comprueban

Cuándo el motor de contenido dibuja una portada, cómo se crean y se comprueban la escena y la imagen sin marcas, el archivo que recibe tu sitio y cómo aportar tu propia imagen.

Propiedad → Contenido5 min de lectura

Si tu sitio muestra una imagen de portada con cada artículo, el motor de contenido le da una a cada artículo. El redactor de AutoPSEO dibuja la portada mientras escribe, con el estilo de tus portadas existentes, y un modelo de visión descarta cualquier imagen con un logotipo o texto legible. Tu propia IA puede aportar su propia imagen en su lugar. Las portadas son JPEG de 1536 por 1024 píxeles, se entregan junto con el artículo y no consumen ni tu cupo de artículos ni tus créditos de investigación.

Cuándo un artículo recibe una portada

AutoPSEO dibuja portadas solo para los sitios que las muestran:

  • Tu sitio renderiza los artículos mediante el webhook y ha indicado que muestra portadas: su respuesta al ping incluye covers: true, o respondió al menos una vez a una entrega con cover: "wanted". A partir de entonces, el redactor de AutoPSEO dibuja la portada justo después de guardar cada borrador, de modo que la primera entrega del artículo ya la incluye.
  • Un artículo llegó sin portada. Responde a esa entrega con cover: "wanted": la tarea programada cada cinco minutos dibuja una, empezando por la solicitud más antigua, y te la envía en un article.updated.
  • AutoPSEO aloja los artículos y la plantilla que aprendió de tu sitio muestra portadas (alojamiento).

Un sitio que no muestra portadas no recibe ninguna. La tarea programada cada cinco minutos abandona un artículo tras tres intentos fallidos. Un artículo publicado conserva su portada hasta que alguien la sustituya con content_set_cover; una revisión pendiente de aprobación nunca la modifica.

Cómo se dibuja una portada

  1. La escena. Un modelo de texto en Workers AI (Llama 3.3) describe para el artículo una escena de 45 palabras como máximo: personas genéricas, el lugar, lo que hacen y los objetos que las rodean. No nombra ninguna empresa, marca, producto, aplicación, sitio web, escuela, persona ni lugar, y no pone nada legible en la imagen. Se rechaza una escena que todavía mencione tu marca. El modelo de imagen nunca ve el artículo en sí.
  2. La imagen. FLUX.2 [klein] dibuja la escena "exactamente con el estilo, la iluminación, la paleta y el encuadre" de hasta dos de tus propias imágenes para compartir o portadas, usadas como referencias. Sin referencias, dibuja una fotografía editorial serena con luz natural. La instrucción pide que no haya texto, letras, números, logotipos ni marcas de agua, que no aparezcan formas abstractas en ninguna pantalla y que los portátiles, teléfonos y monitores sean lisos y sin marca.
  3. La comprobación. Un modelo de visión (Llama 4 Scout) examina el resultado. Una imagen con un logotipo o texto legible cuenta como un intento fallido y se vuelve a dibujar en una ejecución posterior.

El paso de portada del redactor nunca se reintenta por sí solo. Si falla, el artículo sigue adelante sin retrasar nada.

El archivo que recibe tu sitio

PropiedadValor
FormatoJPEG
Tamaño1536 por 1024 píxeles, proporción 3:2
Direcciónhttps://app.autopseo.com/media/covers/<property>/<sha256>.jpg
CachéPública e inmutable durante un año: el nombre del archivo es el SHA-256 de la imagen

Las entregas la incluyen como article.cover con url, sha256, contentType, width y height. Descárgala una vez y conserva tu propia copia; tu sitio es el propietario de la imagen, igual que del resto del artículo. En el alojamiento de AutoPSEO, las portadas se sirven bajo la ruta del tipo de contenido en /_cover/<slug>.jpg, en los tamaños y formatos que usa tu plantilla.

Aporta tu propia imagen

Un redactor que trabaje mediante MCP puede aportar cualquier imagen, creada de la forma que prefiera (tu propia IA):

  • Junto con el borrador: el campo cover de content_submit, ya sea url (una dirección https de la web pública, que se descarga una sola vez) o data (base64, hasta 2.5 MB).
  • Como archivo: una petición PUT con los bytes de la imagen a la coverUploadUrl que devuelve content_submit cuando tu sitio quiere una portada.
  • Más adelante: content_set_cover con una imagen, o sin ella para obtener una dirección de subida. Así es también como se sustituye la portada de un artículo publicado.

AutoPSEO comprueba tu imagen únicamente como imagen: PNG, JPEG o WebP, de entre 10 KB y 12 MB, de al menos 800 píxeles de ancho y 400 de alto, y apaisada (no más alta que ancha, ni más ancha que 2.5 a 1). Se recorta desde el centro a 3:2 y se guarda como un JPEG de 1536 por 1024. La comprobación de visión no se ejecuta sobre tu propia imagen, y esta se conserva incluso cuando AutoPSEO no sabe si tu sitio muestra portadas: eso lo decide tu sitio.

Dibuja con la instrucción de AutoPSEO

Un redactor que tenga su propia herramienta de imágenes puede seguir usando la instrucción y las comprobaciones de AutoPSEO:

  1. Describe una escena de 20 a 600 caracteres y envíala con content_cover. AutoPSEO la comprueba igual que sus propias escenas y devuelve la instrucción de imagen, hasta dos portadas de tu sitio como referencias y una dirección de subida firmada.
  2. Dibuja la imagen a partir de esa instrucción con cualquier herramienta de imágenes y envía los bytes con PUT a la dirección. Esta funciona durante una hora y admite hasta cinco imágenes.
  3. AutoPSEO redimensiona la imagen a 1536 por 1024, ejecuta la comprobación de visión y la conserva. Un artículo publicado se vuelve a enviar a tu sitio con su nueva portada.
Respuesta a la subidaSignificado
403La dirección no es válida o ha caducado
413Supera los 12 MB
415No es una imagen
422La comprobación la rechazó: dibújala de nuevo y envíala a la misma dirección
429La dirección ya ha recibido cinco imágenes; solicita una nueva
409El sitio no muestra portadas

El ejecutor desatendido descrito en tu propia IA usa este flujo con su herramienta make_cover, y dibuja con la Codex CLI o la Grok CLI en tu propio Mac.

Pon tu contenido SEO en piloto automático

Conecta Search Console y tu sitio. AutoPSEO lo analiza y planifica los primeros temas al instante. No necesitas tarjeta de crédito.