POST /v1/humanize
Une requête, une réponse claire : envoyez le texte, recevez la version humanisée et les valeurs d'IA. Le même Humanizer que dans le navigateur – maintenant dans votre code.
La langue est automatiquement détectée et conservée : le français et plus de 40 autres. La facturation se base exactement sur le nombre de mots saisis mesurés.
Créer une clé d'APIVoir la documentation
Inscription gratuite · Facturation par mots saisis · sans durée minimale d'engagement
curl https://api.studytexter.com/v1/humanize \
-H "Authorization: Bearer $STUDYTEXTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "La numérisation place les entreprises face à..."}'{
"humanized_text": "Avec la numérisation, les entreprises sont confrontées à de très...",
"ai_detection": {
"original": { "ai_percent": 81.58, "human_mixed_percent": 18.42 },
"humanized": { "ai_percent": 3.83, "human_mixed_percent": 96.17 }
}
}
Valeurs d'IA à chaque appel – Détecteurs connus notamment de :
Principes de base
L'API Humanizer est une interface REST qui permet de retravailler par programmation des textes issus de ChatGPT, Claude, Gemini ou DeepSeek pour qu'ils sonnent plus naturels – « AI Humanizer API » en anglais, « KI-Humanizer-API » en allemand. Humaniser un texte via l'API signifie que vous envoyez un POST avec votre texte à /v1/humanize et que vous recevez en retour la version humanisée, ainsi que les valeurs de détection d'IA pour les deux versions, en tant que valeur de mesure. Le système utilise la même détection de langue, la même mesure de mots et le même traitement que l'humaniseur d'IA dans le navigateur – il n'y a pas de version allégée pour les développeurs.
Intégration
Pas de SDK, pas d'entretien d'onboarding, pas d'indication de langue. L'API REST se contente d'une clé, d'un endpoint et d'un champ obligatoire dans le body.
Créer une clé
S'inscrire, aller sur la page des clés dans l'application, créer une clé. Le secret complet n'est affiché qu'une seule fois.
Envoyer le texte
POST sur /v1/humanize avec Authorization: Bearer et un body JSON qui ne contient que text. Vous n'envoyez pas d'indication de langue – elle est détectée.
Traiter la réponse
Vous recevez en retour humanized_text et les valeurs d'IA pour l'original et le résultat. En cas d'erreur, error.retryable décide si une deuxième tentative est autorisée.
curl --request POST 'https://api.studytexter.com/v1/humanize' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"text":"La numérisation place les entreprises face à de nombreux défis, car les processus existants doivent être examinés et réorganisés. Une utilisation responsable de l'IA exige toujours un travail minutieux sur les sources et un jugement personnel."}'Le texte d'exemple complet, le fichier OpenAPI et la version Markdown pour les agents sont disponibles dans la documentation.
Agents
Un agent qui génère du texte a besoin de l'Humanizer comme outil – pas comme site web. Trois choses sont décisives lorsque plus personne n'est à côté pour superviser.
Enregistrer comme outil
Un endpoint, un champ obligatoire, pas de commutateurs. La définition de l'outil tient en quelques lignes et peut être enregistrée dans LangChain, dans le SDK Anthropic, dans n8n ou dans une boucle personnalisée.
Dans les processus à plusieurs étapes
L'agent génère du texte avec un modèle, l'envoie via /v1/humanize et transmet le résultat. La langue reste celle de l'ébauche, sans que le processus ait besoin de la connaître.
Répéter sans double facturation
Chaque erreur indique via error.retryable si une nouvelle tentative est sûre. Si la connexion est interrompue sans réponse, une Idempotency-Key déduplique : la même clé avec le même texte renvoie la réponse enregistrée au lieu d'une deuxième facturation.
{
"name": "humanize_text",
"description": "Retravaille une ébauche d'IA pour qu'elle paraisse plus naturelle. La langue est détectée et conservée. Les chiffres, les noms, les sources et les termes techniques sont conservés.",
"input_schema": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Le texte à retravailler. 100 à 30 000 caractères, 3 000 mots maximum."
}
},
"required": ["text"]
}
}Un agent n'a pas besoin de plus. Il n'y a pas de champ de langue, de ton ou d'intensité qu'il pourrait mal définir – et donc pas de degré de liberté où une exécution pourrait échouer silencieusement. La description complète est également disponible en tant que OpenAPI 3.1 et llms.txt ; les deux peuvent être soumis directement à un modèle.
Cas d'utilisation
Partout où un modèle rédige l'ébauche et où un humain est néanmoins l'expéditeur.
Outils d'écriture
Votre éditeur génère une ébauche via un LLM et la passe par l'API avant de l'afficher. Vos utilisateurs voient le résultat, pas l'étape intermédiaire.
Pipelines de contenu
Les chaînes de rédaction et de publication placent l'appel après la génération. Le débit provient de 60 tâches parallèles, et non de textes individuels plus longs.
Frameworks d'agents
LangChain, CrewAI, le SDK Anthropic ou une boucle personnalisée : le endpoint est un outil parmi d'autres et ne nécessite aucun traitement spécial.
SEO et marketing
Textes de blog, descriptions de produits, newsletters. Ce qu'un modèle a rédigé est publié en tant que texte continu, sans que personne n'ait à le peaufiner manuellement.
Plateformes académiques
Environnements d'apprentissage et outils d'écriture dont les utilisateurs travaillent avec des sources. Les références, les numéros de page et les termes techniques sont conservés mot pour mot – c'est précisément le point sur lequel la plupart des humaniseurs échouent.
Marque blanche et SaaS
L'humanisation comme fonctionnalité propre dans votre produit, sous votre nom. La facturation s'effectue via votre compte StudyTexter ; vos utilisateurs n'en voient rien.
Différences
Non pas parce qu'elle est plus rapide que les autres, mais parce qu'elle a moins d'endroits où quelque chose peut tomber en panne silencieusement.
La langue est reconnue, pas spécifiée
Vous n'envoyez pas de champ `language`. La langue dominante du texte d'entrée est reconnue et conservée dans la réponse – plus de 40 langues. Un paramètre mal défini ne peut rien casser.
Valeurs d'IA pour les deux versions
La réponse contient les probabilités du détecteur pour le texte original et pour le résultat. Vous pouvez afficher ou consigner dans votre produit ce qui a changé – sans outil supplémentaire.
Les sources sont conservées mot pour mot
Les citations, numéros de page, noms d'auteurs et années ne sont pas reformulés. C'est la raison pour laquelle l'API peut être utilisée dans des produits académiques.
Facturation par mots saisis
Le texte que vous envoyez est compté – avec une segmentation ICU sur une copie normalisée NFC. La longueur de la réponse ne modifie pas le prix.
Le même moteur que dans le navigateur
573,7 millions de mots humanisés et plus de 63 573 utilisateurs passent par le même traitement. Ce que l'API fournit, vous pouvez le contre-vérifier dans l'interface.
Mises à jour du modèle incluses
Les améliorations du traitement atteignent l'API en même temps que l'interface. Vous n'avez rien à changer à votre intégration pour cela.
Tarifs
L'API n'a pas de tarifs propres. Elle utilise le même crédit que l'outil dans le navigateur – abonnement ou achat unique, les deux sont valables pour les deux accès.
GPTZero classe nos textes comme plus humains que de vrais textes d'étudiants (Ø 84 % vs 80 %).
Plus de 573,7 millions de mots humanisésStudent
14,99 €par mois
5,00 € / 10 000 motsLa garantie s'applique au scanner d'IA GPTZero : si votre texte humanisé y est détecté comme étant de l'IA, nous vous remboursons les mots utilisés. Un court message au support suffit.
Démarrer l'abonnementOu acheter en une seule fois
Starter
9,99 €paiement unique
12,49 € / 10 000 motsStandard
34,99 €paiement unique
8,75 € / 10 000 motsPower
69,99 €paiement unique
7,78 € / 10 000 motsL'API publique utilise exclusivement des mots payants : le contingent de l'abonnement et les packs achetés. Le contingent mensuel gratuit ne s'applique qu'à l'interface web.
Enterprise à partir de 150 000 mots/mois
Tarifs personnalisés pour les agences, les ghostwriters et les intégrations d'outils. Répondez brièvement à quatre questions – nous vous contacterons dans les 24 heures.
Paiement sécurisé via Stripe · résiliable à tout moment, sans durée minimale d'engagement
Réponse
Un champ avec le résultat, un objet avec les valeurs de mesure. Pas besoin de plus de structure.
{
"humanized_text": "…",
"ai_detection": {
"original": {
"human_mixed_percent": 18.42,
"human_percent": 8.29,
"mixed_percent": 10.13,
"ai_percent": 81.58
},
"humanized": {
"human_mixed_percent": 96.17,
"human_percent": 83.04,
"mixed_percent": 13.13,
"ai_percent": 3.83
}
}
}humanized_text
La version retravaillée dans la langue du texte d'entrée. La structure et la longueur restent proches de l'original.
ai_detection.original
Les probabilités pour le texte que vous avez envoyé : ai_percent, human_percent, mixed_percent et human_mixed_percent.
ai_detection.humanized
Les mêmes quatre valeurs pour le résultat. La comparaison des deux objets correspond à la vérification avant/après de l'interface web.
X-Request-ID
En-tête que vous consignez. Le support peut ainsi associer une seule exécution sans que vous ayez à renvoyer votre texte.
Les valeurs d'IA sont des probabilités de classe, pas des proportions de phrases – et ne constituent pas une preuve. Les détecteurs classent aussi mal des textes humains. Des valeurs individuelles peuvent être nulles s'il n'y a pas de mesure ; votre intégration doit être préparée à cela.
Ce qui est conservé
La structure des phrases, les transitions et le choix des mots sont modifiés. Le contenu, dont votre produit est responsable, est conservé.
Sens
Les affirmations restent des affirmations. Rien n'est ajouté qui ne figurait pas dans le texte d'entrée.
Numéros et identifiants
Numéros de dossier, DOI, ISBN, numéros d'article : les chaînes de caractères sont reprises, pas redéfinies.
Noms et noms propres
Les personnes, les institutions, les produits et les lieux conservent leur orthographe.
Chiffres, dates et unités
Les valeurs mesurées restent non arrondies, non converties et à leur place.
Termes techniques et abréviations
La terminologie n'est pas remplacée par un mot courant simplement parce que cela sonne plus familier.
Registre et formule d'adresse
Vouvoyer ou tutoyer, sobre ou narratif : le niveau de langue du texte d'entrée est conservé.
Facturation
L'API n'a pas de tarifs propres. Elle déduit du même crédit que celui utilisé par l'outil dans le navigateur.
Les mots saisis sont facturés
Le texte que vous envoyez est compté avec exactitude. La longueur de la réponse n'a aucune incidence sur le prix.
L'API utilise des mots payants
Le contingent mensuel gratuit est valable pour l'interface web. L'API publique accède exclusivement au crédit payant.
Rejeté ne veut pas dire facturé
Les requêtes qui échouent en raison d'une limite ne sont ni mises en file d'attente, ni facturées. Pour les erreurs répétables, la réservation est libérée.
Pas de deuxième contrat
Le crédit et l'abonnement sont gérés via votre compte existant et peuvent y être résiliés. Il n'y a pas de frais supplémentaires pour l'API.
curl 'https://api.studytexter.com/v1/balance' \
--header "Authorization: Bearer $STUDYTEXTER_API_KEY"
{
"balance": {
"subscription": null,
"subscription_words_remaining": 0,
"purchased_words_remaining": 12000,
"total_api_words_available": 12000
}
}Sécurité
Quatre points à clarifier avant l'intégration.
La clé reste côté serveur
stx_live_… doit être stocké dans un gestionnaire de secrets – pas dans des bundles de navigateur, des applications mobiles, des URL, des prompts ou des logs. Anonymisez l'en-tête Authorization avant de consigner les requêtes.
Visible une seule fois, révocable à tout moment
Le secret complet est affiché une seule et unique fois lors de sa création. La création, la liste et la révocation se font exclusivement via la page des clés une fois connecté.
Une clé, de nombreuses tâches
La même clé authentifie un nombre illimité de tâches, successivement ou en parallèle. L'Idempotency-Key est autre chose : un identifiant de tâche, pas un secret.
Pas d'entraînement avec vos textes
Vos textes sont traités pour la tâche demandée. Nous ne les utilisons pas pour entraîner des modèles d'IA.
Questions
Une interface REST qui vous permet de retravailler par programmation des textes d'IA pour qu'ils sonnent plus naturels. Un POST sur /v1/humanize avec votre texte, et vous recevez en retour la version humanisée et les valeurs de détection d'IA pour les deux versions. Le traitement sous-jacent est le même que celui de l'humaniseur d'IA dans le navigateur.
Oui, sur le fond. L'API de l'humaniseur d'IA utilise la même détection de langue, la même mesure de mots et le même traitement que l'humaniseur d'IA dans l'interface web. Seuls l'accès – Bearer-Token au lieu de login – et le crédit diffèrent : l'API publique utilise exclusivement des mots payants.
En tant qu'outil. Vous définissez une définition d'outil avec un seul champ obligatoire – le texte – et l'agent l'appelle lorsqu'une sortie doit être retravaillée. Cela fonctionne de la même manière dans LangChain, CrewAI, le SDK Anthropic ou dans une boucle personnalisée. Pour les modèles, les descriptions sont également disponibles en OpenAPI 3.1, en Markdown et en tant que llms.txt.
Inscrivez-vous gratuitement ou connectez-vous, ouvrez la page des clés dans l'application et créez une clé. Vous ne verrez le secret complet qu'une seule fois – copiez-le immédiatement dans votre gestionnaire de secrets. Vous pouvez le révoquer à tout moment.
Via un Bearer-Token dans l'en-tête Authorization : Authorization: Bearer stx_live_… La même clé est valable pour /v1/humanize et /v1/balance et peut authentifier de nombreuses tâches, successivement ou en parallèle. Elle doit être utilisée exclusivement dans du code côté serveur.
Avec du texte provenant de tous les modèles courants – ChatGPT, Claude, Gemini, DeepSeek, Llama, Mistral et autres. L'API reçoit du texte, pas un nom de modèle : ce qui compte, ce sont les motifs dans l'ébauche, pas son origine.
Nous ne le promettons pas. L'API fournit une formulation plus naturelle ainsi que les valeurs d'IA mesurées pour l'original et le résultat. Ces valeurs sont des probabilités de classe d'un détecteur – pas une preuve ni une garantie. Les détecteurs modifient leurs modèles, aboutissent à des évaluations différentes selon le fournisseur et classent également mal des textes purement humains. Ce que vous obtenez, c'est une comparaison avant/après traçable que vous pouvez afficher ou consigner dans votre produit.
Non, et vous ne le pouvez pas non plus. La langue dominante du texte d'entrée est détectée et conservée dans la réponse – le français et plus de 40 autres. L'API n'accepte pas de champ `language`.
Oui. La facturation se base exactement sur le nombre de mots saisis mesurés, quelle que soit la longueur de la réponse. L'API publique utilise exclusivement des mots payants ; le contingent mensuel gratuit est valable pour l'interface web. Vous pouvez consulter le solde actuel avec GET /v1/balance.
Oui, par utilisateur : 60 nouvelles tâches par 60 secondes, 60 en traitement simultané et 30 consultations de solde par minute. Les requêtes excédentaires sont rejetées avec le code 429, non mises en file d'attente et non facturées. Le cas échéant, l'en-tête Retry-After indique le temps d'attente.
En cas d'erreur avec error.retryable=true, la réservation a été libérée – une nouvelle tentative est sûre. Si la connexion est interrompue sans aucune réponse, vous ne connaissez pas le résultat : pour ce cas, il y a l'Idempotency-Key optionnel. Avec la même clé et le même texte, vous recevez la réponse enregistrée au lieu d'une deuxième facturation.
L'utilisation se fait via votre compte StudyTexter et est facturée par ce biais, même si ce sont vos propres utilisateurs qui déclenchent l'appel. Les conditions contractuelles applicables sont définies dans nos CGV ; pour des volumes plus importants ou des questions sur l'utilisation, veuillez nous contacter au préalable.
Créez votre clé et envoyez votre première requête
POST /v1/humanize · Facturation par mots saisis · sans durée minimale d'engagement