Humanizer IA API
Humanisez du texte IA dans votre produit avec un seul appel REST. L'API humanizer IA expose à votre backend le moteur qui alimente TextPulse : le JSON entre, une prose réécrite ressort, dans plus de 60 langues.
Faire votre première requête
Authentifiez-vous avec un en-tête Authorization: Bearer et envoyez votre texte. La version réécrite est renvoyée comme outputText, avec les indicateurs de comptage de cet appel.
curl https://textpulse.ai/api/v1/humanize \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Our analysis indicates the intervention produced gains...", "writingMode": "Academic", "intensityScalar": 0.5 }'{ "outputText": "Our analysis points to measurable gains from the...", "metrics": { "inputWords": 128, "outputWords": 134, "wordsCharged": 128, "balanceRemaining": 99872, "modelLatencyMs": 4310, "route": "v1/humanize" }}Qu’est-ce qu’une API de humanizer IA ?
Une API de humanizer IA est un point de terminaison REST qui réécrit un texte généré par machine en une prose naturelle, au son humain, depuis un autre produit. Au lieu de coller le texte dans une application web, votre backend l’envoie sous forme de JSON et reçoit la version réécrite dans la réponse, de sorte que l’humanisation devient une fonctionnalité de votre propre logiciel, un bouton dans un éditeur, une étape dans un pipeline documentaire, un traitement par lots sur une bibliothèque de contenus.
L’API humanizer de TextPulse expose le même moteur que celui qui alimente le tableau de bord TextPulse. Elle fonctionne simultanément sur plus de 20 signaux linguistiques, en faisant varier la longueur et la structure des phrases et en remplaçant le vocabulaire que les modèles de langage surutilisent, tandis que les citations dans le texte, les entrées de référence, les statistiques et la terminologie figée sont conservées à l’identique. Sur un corpus académique de 2,000 documents, la sortie humanisée a passé Turnitin AI 92.33% du temps, Originality.ai 89.12% et GPTZero 87.91%. Ce comportement de niveau académique est ce qui la distingue des points de terminaison de paraphrase génériques, le texte que vos utilisateurs récupèrent est publiable, pas seulement différent.
Ce que l'API humanizer IA gère pour vous
Le routage linguistique, le contrôle du registre, le comptage et la sécurité des reprises font partie du point de terminaison, afin que votre intégration reste une seule fonction.
Un seul itinéraire couvre 60+ langues
L'anglais utilise le moteur humanizer affiné. Fournissez une valeur de langue et la requête est routée vers le chemin multilingue à la place, afin qu'une page produit non anglaise atteigne le même point de terminaison sans seconde intégration.
Le registre et l'intensité sont des paramètres
Cinq modes d'écriture couvrent les registres Academic, Corporate, Creative, Blog/SEO et General. La valeur intensityScalar détermine à quel point la réécriture diffère de la source et prend 0, 0.25, 0.5, 0.75 ou 1, de Mild à Aggressive, avec le réglage Balanced par défaut à 0.5.
Un POST par document
Il n'y a ni file de tâches à interroger ni webhook à enregistrer. L'appel humanize maintient la connexion jusqu'au retour du modèle et répond avec le texte réécrit, de sorte qu'une seule requête accomplit le travail.
Les reprises ne sont pas facturées deux fois
Envoyez un requestId et le résultat y est mis en cache pendant environ dix minutes. Une répétition du même identifiant dans cette fenêtre renvoie la réponse stockée plutôt que de relancer le modèle, et toute requête que le moteur ne parvient pas à terminer restitue automatiquement ses mots à votre solde.
Référence du point de terminaison
Authorization: Bearer. Les clés commencent par tp_live_ et sont émises par projet./api/v1/humanize/api/v1/balanceUn seul appel humanize accepte jusqu'à 1,000 mots dans une limite de 10,000 caractères, et chaque clé peut émettre 60 requêtes par minute. Les documents plus longs sont envoyés sous forme de suite d'appels.
Paramètres de requête
Seul text est requis. Tout le reste a une valeur par défaut raisonnable, donc l’intégration minimale tient en un seul champ.
| Paramètre | Type | Présence | Remarques |
|---|---|---|---|
text | string | Requis | Le texte à humaniser. Jusqu’à 1,000 mots dans une limite de 10,000 caractères par requête. |
writingMode | string | Par défaut : Academic | L’une des valeurs Academic, Corporate, Creative, Blog/SEO ou General. Définit le registre que la réécriture conserve. |
intensityScalar | number | Par défaut : 0.5 | L’une des valeurs 0, 0.25, 0.5, 0.75 ou 1. Mesure l’écart de la réécriture par rapport au texte source, de Mild à Aggressive en passant par Balanced. |
language | string | Facultatif | Oriente le texte non anglais vers le parcours multilingue. Omettez-le, ou envoyez de l’anglais, pour le moteur anglais affiné. |
englishVariant | string | Facultatif | American ou British. Maintient l’orthographe et le vocabulaire d’un côté de l’Atlantique. |
freezeTerms | string[] | Facultatif | Jusqu’à 10 termes ou expressions qui traversent la réécriture à l’identique : noms de constructions, instruments, noms de produits. |
removeEmDashes | boolean | Facultatif | Réécrit les constructions avec tiret cadratin en ponctuation conventionnelle. |
requestId | string | Recommandé | Votre jeton d’idempotence. Le répéter dans un délai d’environ dix minutes rejoue la réponse stockée au lieu de facturer à nouveau. |
Champs de réponse
outputTextLe texte humanisé.metrics.inputWords / outputWordsMots reçus et mots renvoyés. Les réécritures sont souvent légèrement plus longues que le texte source.metrics.wordsChargedLe coût de l’appel. Correspond toujours au nombre d’entrées, jamais au nombre de sorties.metrics.balanceRemainingCrédits de mots restants sur la clé après cet appel, afin que vous puissiez mesurer sans seconde requête.metrics.modelLatencyMs / routeTemps du moteur pour la réécriture et chemin qui l’a servie.Erreurs et nouvelles tentatives
Chaque erreur renvoie du JSON avec un error.code stable et un message lisible. La règle à prendre en compte dans la conception est la suivante, vous n’êtes facturé que pour une réécriture effectivement livrée, et relancer avec le même requestId est toujours sans risque.
UNAUTHORIZEDClé API manquante ou non reconnue. Vérifiez l’en-tête Authorization: Bearer.INSUFFICIENT_BALANCECrédits de mots insuffisants sur la clé. La réponse inclut le solde disponible.REQUEST_IN_PROGRESSUne requête avec ce requestId est encore en cours de traitement. Attendez-la plutôt que de la devancer.TOO_LONG / VALIDATION_FAILEDL’entrée dépasse la limite de 1,000 mots ou un paramètre est mal formé. La réponse liste les problèmes exacts.ENGINE_ERRORLe moteur a échoué ou a expiré. Les mots ont déjà été recrédités sur votre solde, réessayez avec le même requestId.Le moteur derrière le point de terminaison
Chaque appel exécute le moteur TextPulse publié, mesuré sur un corpus académique de 2,000 documents et relancé à mesure que les modèles de détection évoluent. Taux de réussite par détecteur :
Chiffres mesurés par le fournisseur, publiés avec leur corpus. Aucun humanizer ne peut promettre le résultat d'un détecteur sur un document précis, donc fondez le message de votre produit sur la mesure, et non sur une garantie.
Ce que les équipes construisent sur l'API humanizer
Plateformes EdTech et d'écriture
Ajoutez une action humanize à côté de vos fonctions existantes de correction grammaticale ou de paraphrase. Le mode Academic conserve les citations intactes, de sorte que les outils destinés aux étudiants n'ont pas à supprimer les références avant l'envoi du texte.
Outils de traitement de documents et de relecture
Faites passer des documents entiers par blocs de 1,000 mots, puis réassemblez-les. Les termes freeze terms maintiennent les noms et la terminologie stables d'un bloc à l'autre, et les nouvelles tentatives idempotentes permettent de relancer sans risque les pipelines par lots.
Produits de contenu et de SEO
Le mode Blog/SEO réécrit les brouillons en prose publiable tandis que freeze terms verrouille les mots-clés cibles, de sorte que le texte conserve son intention de recherche et perde le rythme mécanique.
Partenaires en marque blanche
Le point de terminaison fonctionne de manière invisible au sein de votre produit : votre interface, votre facturation, notre moteur. Les accords partenaires sont chiffrés selon le volume mensuel via le formulaire d'accès.
Tarifs de l'API humanizer IA
Les crédits sont prépayés et débités au mot. La facturation compte ce que vous envoyez plutôt que ce que le moteur renvoie, et tout appel qui ne parvient pas à produire une réécriture est recrédité sur la clé.
Les crédits sont valables pendant 12 mois à compter de l’achat, et couvrent chaque langue, mode d’écriture et variante anglaise pris en charge par l’endpoint. Pour un volume soutenu ou un accord en marque blanche au sein de votre propre produit, demandez l’accès et nous établirons un devis en fonction de votre volume mensuel.
Questions sur l’API humanizer IA
Obtenez votre clé API
Les clés sont attribuées par projet. Décrivez ce que vous construisez et nous vous répondrons sous 24 heures.