Une entrée JSON simple
Envoyez le brouillon et le nom d’un modèle pris en charge. La réponse contient le texte brut, le modèle et le nombre de mots traités.
API REST / Réécriture de texte
API d’humanisation de texte IA pour des réécritures naturelles et modifiables
Envoyez un brouillon, choisissez un modèle d’humanisation et recevez une nouvelle version dans votre propre processus. La réponse reste facile à modifier, à comparer et à valider avant toute publication.
Utilisez la clé depuis un environnement serveur privé.
Requête cURL
curl --request POST \
--url https://api.detecting-ai.com/api/humanize/ \
--header "Content-Type: application/json" \
--header "Idempotency-Key: humanizer-review-001" \
--header "X-API-Key: YOUR_API_KEY" \
--data '{
"text": "Paste the text you want to rewrite.",
"model": "cognia"
}'01
Requêtes POST vers /api/humanize/
02
Authentification par X-API-Key
03
En-tête Idempotency-Key défini par le client pour reprendre une requête
04
Quatre modèles pris en charge
05
Usage en mots dans chaque réponse
Une étape de réécriture que vous contrôlez
Réunissez le texte source, la réécriture et la version finale dans un même processus
Une bonne intégration d’humanisation ne masque pas les modifications. Conservez l’original, demandez une réécriture et donnez à la personne chargée de la révision un espace clair pour comparer les deux versions avant de valider le résultat.
Le choix du modèle reste explicite
Choisissez cognia, lexi, cognia_v2 ou huma_v2 selon le comportement que votre équipe a testé sur ses propres contenus.
Un résultat modifiable par conception
Replacez le texte renvoyé dans un éditeur, une file de révision ou un système de contenu au lieu de le considérer comme une version définitive.
Contrat de la requête
Envoyez le brouillon et indiquez le modèle
Les deux champs sont obligatoires pour le point de terminaison REST. Placez le choix du modèle dans la configuration afin de pouvoir le tester et le modifier sans réécrire l’intégration.
| Champ | Type | Obligatoire | Fonction |
|---|---|---|---|
| text | string | Oui | Le texte transmis que le service doit réécrire. |
| model | string | Oui | L’une des valeurs cognia, lexi, cognia_v2 ou huma_v2. |
Trois champs facilitent le suivi du résultat
Utilisez humanized_text comme résultat modifiable. Enregistrez aussi model_used et words_processed afin que les équipes d’assistance, de facturation et de contenu comprennent le déroulement de la requête.
Exemple de réponse
{
"humanized_text": "The rewritten text is returned here.",
"words_processed": 8,
"model_used": "cognia"
}Parcours d’intégration
Traitez l’humanisation comme une étape de révision
Le processus le plus fiable garde l’original visible et demande à une personne de valider la nouvelle version.
- 1
Protéger la clé API
Conservez la clé sur votre serveur ou dans un gestionnaire de secrets. Ne la placez pas dans du code public exécuté dans le navigateur ni dans un document partagé.
- 2
Envoyer le texte avec un modèle testé
Choisissez un modèle pris en charge, enregistrez une valeur Idempotency-Key unique avant l’envoi et ne réutilisez cette clé que pour relancer exactement la même requête.
- 3
Examiner et valider
Vérifiez l’exactitude, le sens, le ton et la terminologie requise du texte réécrit avant de l’enregistrer ou de le publier.
Cas adaptés
Une solution pratique pour les produits qui possèdent déjà un éditeur
L’humanisation est surtout utile lorsqu’un brouillon passe déjà par une révision. L’API ajoute une option de réécriture sans remplacer les personnes responsables de la version finale.
Une réécriture peut modifier le sens
Les noms, citations, chiffres, formulations juridiques et termes techniques méritent une vérification attentive. Gardez ces éléments visibles pour la personne qui révise le texte.
Gestion de contenu
Proposez une action de réécriture dans un CMS et renvoyez le résultat dans le même brouillon pour le comparer et le valider.
Opérations d’assistance
Transformez un contenu source validé en texte d’aide plus clair, puis soumettez-le aux vérifications habituelles des faits et des règles internes.
Files de révision éditoriale
Placez une proposition de réécriture à côté de l’original afin que la personne chargée de la révision puisse conserver, combiner ou refuser chaque modification.
Outils d’écriture privés
Appelez le service depuis un backend de confiance et n’affichez que le texte dont l’utilisateur connecté a besoin.
FAQ de l’API
Des réponses pratiques avant la mise en production
Commencez par une requête côté serveur, consignez la structure de la réponse, puis ajoutez le résultat à votre processus de vérification existant.
Quel point de terminaison utilise l’API d’humanisation de texte IA ?+
Envoyez une requête POST à https://api.detecting-ai.com/api/humanize/. Utilisez JSON, transmettez votre clé dans X-API-Key et conservez une Idempotency-Key stable pour chaque opération logique afin de pouvoir reprendre les tentatives.
Quels modèles d’humanisation sont disponibles ?+
Les valeurs de modèle prises en charge sont cognia, lexi, cognia_v2 et huma_v2. L’API REST attend le champ model dans chaque requête.
Que contient la réponse ?+
Une réponse réussie contient humanized_text, words_processed et model_used. Le texte réécrit reste modifiable dans votre produit.
Peut-on publier le résultat de l’API sans le vérifier ?+
Non. Vérifiez le sens, les faits, le ton, les noms, les liens et toute formulation qui doit rester exacte. Une réécriture peut améliorer la fluidité tout en nécessitant une révision humaine.
Comment l’usage de l’humaniseur est-il comptabilisé ?+
L’usage se fonde sur le nombre de mots du texte d’entrée et est déduit du quota d’humanisation associé à l’abonnement API. Les réponses réussies indiquent words_processed.
Construire la première requête
Testez la réécriture sur un texte que vous connaissez bien
Commencez avec un seul modèle, comparez le résultat à la source et définissez les vérifications dont vos équipes auront besoin avant la mise en production.