Humanizer

L'Humanizer réécrit le texte IA pour qu'il sonne moins IA — autre rythme de phrase, moins de formules toutes faites, voix plus personnelle, plus de variation. Tu as deux portes d'entrée : Single-Article (1-clic sur un article existant, sync) ou Batch Mode (paquets de free-text avec plusieurs documents simultanément, async). Les outputs sont souvent tels que les outils détecteurs en aval (y compris notre propre AI-Detector) abaissent nettement le score. Obligatoire pour quiconque publie des drafts IA sans que ça sente l'IA.

Ce qu'il peut faire

• Humanize Single-Article — sync, un clic dans l'éditeur : POST /ai-scanner/humanize avec {article_id, level}. Le résultat remplace directement le body de l'article.
• Humanize Bulk — async, batch-API : POST /humanize avec liste de free-text. Le job tourne en background, statut pollable.
• Levels — light (cosmétique, ~10% de modification), medium (par défaut, ~25%), heavy (~50%, peut décaler légèrement le sens).
• Conservation du style — si ton projet a un Style Profile, l'output Humanize est ajusté à ton ton.
• Vue diff — avant / après dans l'éditeur, phrase par phrase.
• Roundtrip avec AI-Detector — un nouveau run Detect possible directement après Humanize, pour valider le score.
• Document tracking — les runs batch ont des Document-IDs individuels, chacun avec son propre statut.

Quand l'utiliser

• Tu as un draft AI Content Editor terminé et tu veux le désamorcer avant publication.
• Tu importes des textes d'autres outils IA et tu veux les caler sur ton ton + un AI-Score plus bas.
• Tu fais une migration bulk : 200 vieux articles IA doivent tous passer une fois par l'Humanizer.
• Tu construis une pipeline « Generate → Humanize → Detect → Publish » et tu as besoin de l'étape Humanize.

Workflow

Single-Article (sync)

1. Cliquer sur « Humanize » dans l'éditeur ou API : POST /ai-scanner/humanize avec {article_id, level: "medium"}.
2. La réponse sync livre le body réécrit — remplacé directement dans l'article.
3. Optionnel : Re-Scan avec AI-Detector.

Batch (async)

1. Rassembler les textes et envoyer à POST /humanize (HTTP 202 + batch_id).
2. Poller le statut avec GET /humanize/{batch_id} — valeurs : pending, processing, completed, failed.
3. Récupérer les documents individuels via GET /humanize/{batch_id}/documents/{document_id}.
4. Résultats de retour dans ton workflow / importer.

API

Body de POST /ai-scanner/humanize (sync, single article) :

{
  "article_id": 4711,
  "level": "medium"
}

Body de POST /humanize (async, batch) :

{
  "project_id": 12,
  "documents": [
    {"id": "doc-a", "text": "..."},
    {"id": "doc-b", "text": "..."}
  ],
  "level": "medium"
}

Réponse : HTTP 202 avec { "batch_id": "hum-9182", "status": "pending" }.

Crédits et limites

• Single-Article (/ai-scanner/humanize) : 5 crédits par appel.
• Batch (/humanize) : 8 crédits par document dans le batch.
• Polls de statut et fetches de document : gratuits.
• Limite sync : Single-Article tourne contre la limite PHP-FPM de 600 s — pour les articles très longs (>20k caractères), tu es redirigé vers le mode batch.
• Taille de batch : jusqu'à 50 documents par batch, max 25k caractères chacun.
• Idempotence : re-run sur le même article/texte autorisé, coûte des crédits à chaque fois.

Modules associés

• AI-Detector — le check naturel avant et après.
• AI Content Editor — Humanize Single-Article est intégré ici comme bouton.
• Content Optimizer — Optimize + Humanize sont souvent enchaînés utilement.
• Automation — configurable comme étape de pipeline.