Bulk Generation

Bulk Generation crée plusieurs articles en une seule fois à partir d'une liste de mots-clés — au lieu de créer chaque article individuellement, tu saisis jusqu'à 50 mots-clés et chacun devient son propre brouillon d'article. En arrière-plan, chaque mot-clé passe par le même pipeline que la génération d'un article seul : d'abord un plan (storyline) est généré, puis le texte est rédigé section par section. Le bulk lui-même et chaque article qu'il contient ont leur propre statut, que tu peux suivre en direct — si un mot-clé échoue, les autres continuent.

Ce qu'il peut faire

• Jusqu'à 50 mots-clés par bulk (keywords[], au moins 2 caractères chacun) — chaque mot-clé devient son propre brouillon d'article.
• Entièrement asynchrone — tourne en tant que job de queue en arrière-plan, tu peux quitter la page, la progression est rechargée depuis la base de données.
• Deux niveaux de statut : le bulk lui-même (pending → processing → completed/failed) et chaque item individuel (pending → generating → completed/failed).
• Tolérance aux erreurs — un mot-clé en échec ne bloque pas les autres ; le bulk passe à completed dès qu'au moins un article est terminé.
• Options du formulaire (UI uniquement, pas via la REST-API) : nombre de mots, profil de style, objectif de contenu et liste de liens comme paramètres par défaut de la génération.
• Options API : type d'article (blog-post, guide, listicle) et langue (de, en, es, fr) directement dans la requête.

Quand l'utiliser

• Tu veux produire 10, 20 ou 30 articles pour des mots-clés apparentés sans déclencher chacun individuellement.
• Un rollout de site ou une nouvelle catégorie a besoin de plusieurs brouillons d'articles d'un coup.
• Tu as une liste de mots-clés prête depuis Keyword Explorer et tu veux la transformer directement en contenu.
• Tu n'as pas besoin d'une solution pleinement automatisée et permanente (c'est Automation pour ça), mais d'un lot ponctuel et contrôlé de nouveaux articles.

Workflow

1. Démarrer un bulk — POST /v1/bulk-generations avec {project_id, name, keywords: [...], type?, language?} → 202 avec {bulk_id, total_articles}. Rate-limit : max. 10 démarrages par minute.
2. Vérifier le statut — GET /v1/bulk-generations/{bulk} renvoie le bulk avec tous ses items (statut, mot-clé, ID de l'article, crédits consommés, message d'erreur).
3. Aperçu — GET /v1/bulk-generations?project_id=&status= liste tous les bulks de l'équipe, paginé.
4. Gérer les erreurs — les items avec status: failed portent un error_message ; les autres items du même bulk continuent indépendamment.
5. Poursuivre le traitement — les articles terminés (items[].article_id) atterrissent comme brouillons dans le projet et peuvent être affinés ensuite, par exemple via Content Optimizer.

API

Valeurs de statut du bulk : pending, processing, completed, failed. Valeurs de statut de l'item : pending, generating, completed, failed.

Exemple :

POST /v1/bulk-generations
{
  "project_id": 42,
  "name": "Série guides août",
  "keywords": ["détartrer chauffe-eau", "entretien chaudière", "panne chauffe-eau instantané"],
  "language": "fr"
}

Crédits et limites

• 4 crédits par article (config/credits.php → bulk_generation_article), prix total = nombre de mots-clés × 4.
• Au démarrage via l'API, les crédits sont intégralement déduits à la création du bulk ; si le solde est insuffisant, l'endpoint répond 402 (insufficient_credits).
• Maximum 50 mots-clés par appel de bulk.
• Le démarrage est limité à 10 requêtes par minute.

Modules associés

• Keyword Explorer — la source typique de la liste de mots-clés qui alimente le bulk.
• Storylines — Bulk Generation utilise en interne le même pipeline de plan et de sections.
• Content Optimizer — l'étape suivante naturelle pour affiner les brouillons de bulk terminés.
• Automation — quand tu ne veux plus déclencher ça manuellement mais le faire tourner en automatique en continu.