Bulk Generation

Bulk Generation crea varios artículos de una vez a partir de una lista de keywords — en lugar de crear cada artículo individualmente, introduces hasta 50 keywords y cada una se convierte en su propio borrador de artículo. En segundo plano, cada keyword pasa por el mismo pipeline que la generación de un artículo individual: primero se genera un esquema (storyline), luego el texto se escribe sección por sección. El bulk en sí y cada artículo dentro de él tienen su propio estado, que puedes seguir en vivo — si una keyword falla, las demás siguen su curso.

Qué puede hacer

• Hasta 50 keywords por bulk (keywords[], mínimo 2 caracteres cada una) — cada keyword se convierte en su propio borrador de artículo.
• Totalmente asíncrono — corre como un queue job en segundo plano, puedes abandonar la página, el progreso se recarga desde la base de datos.
• Dos niveles de estado: el bulk en sí (pending → processing → completed/failed) y cada item individual (pending → generating → completed/failed).
• Tolerancia a fallos — una keyword fallida no bloquea a las demás; el bulk pasa a completed en cuanto al menos un artículo terminó.
• Opciones del formulario (solo UI, no vía la REST-API): cantidad de palabras, perfil de estilo, objetivo de contenido y lista de enlaces como valores por defecto de la generación.
• Opciones de la API: tipo de artículo (blog-post, guide, listicle) e idioma (de, en, es, fr) directamente en el request.

Cuándo usarlo

• Quieres producir 10, 20 o 30 artículos para keywords relacionadas sin lanzar cada uno individualmente.
• Un rollout de sitio o una nueva categoría necesita varios borradores de artículos de golpe.
• Tienes una lista de keywords lista desde Keyword Explorer y quieres convertirla directamente en contenido.
• No necesitas una solución permanente totalmente automatizada (para eso está Automation), sino un lote puntual y controlado de artículos nuevos.

Workflow

1. Iniciar un bulk — POST /v1/bulk-generations con {project_id, name, keywords: [...], type?, language?} → 202 con {bulk_id, total_articles}. Rate-limit: máx. 10 inicios por minuto.
2. Consultar el estado — GET /v1/bulk-generations/{bulk} devuelve el bulk incluyendo todos los items (estado, keyword, ID de artículo, créditos consumidos, mensaje de error).
3. Visión general — GET /v1/bulk-generations?project_id=&status= lista todos los bulks del equipo, paginado.
4. Gestionar errores — los items con status: failed llevan un error_message; el resto de items del mismo bulk siguen corriendo de forma independiente.
5. Seguir procesando — los artículos terminados (items[].article_id) quedan como borrador en el proyecto y pueden pulirse después, por ejemplo vía Content Optimizer.

API

Valores de estado del bulk: pending, processing, completed, failed. Valores de estado del item: pending, generating, completed, failed.

Ejemplo:

POST /v1/bulk-generations
{
  "project_id": 42,
  "name": "Serie de guías agosto",
  "keywords": ["descalcificar calentador", "mantenimiento caldera", "avería calentador instantáneo"],
  "language": "es"
}

Créditos y límites

• 4 créditos por artículo (config/credits.php → bulk_generation_article), precio total = número de keywords × 4.
• En un inicio vía la API, los créditos se deducen íntegramente al crear el bulk; si el saldo no alcanza, el endpoint responde 402 (insufficient_credits).
• Máximo 50 keywords por llamada de bulk.
• El inicio está limitado a 10 solicitudes por minuto.

Módulos relacionados

• Keyword Explorer — la fuente típica de la lista de keywords que alimenta el bulk.
• Storylines — Bulk Generation usa internamente el mismo pipeline de esquema y secciones.
• Content Optimizer — el siguiente paso natural para pulir los borradores de bulk terminados.
• Automation — cuando ya no quieras lanzar esto manualmente sino tenerlo corriendo de forma automática.