API humanizer IA : Humanizer API v2 et Detector API pour développeurs

L'API humanizer IA d'Academic Humanizer propose deux endpoints REST aux développeurs et aux institutions : POST /api/v2/external/humanize, qui renvoie un texte humanisé avec les modifications au niveau de la phrase, et POST /api/v2/external/detector, qui renvoie une évaluation de détection d'IA pour un texte allant jusqu'à 100 000 caractères. Les deux utilisent une clé API côté serveur et puisent dans le même solde de crédits que votre compte.

Cet article présente le public visé par l'API, le fonctionnement de l'authentification et du contrôle d'accès, ce que renvoie chaque endpoint, et la façon dont les crédits sont comptés. La documentation complète se trouve sur /docs.

À qui s'adresse l'API de humanizer IA

L'éditeur web convient aux chercheurs individuels. L'API convient aux produits et aux équipes qui traitent des textes académiques en volume ou dans leur propre interface :

• Les plateformes d'écriture qui veulent proposer une étape d'humanisation dans leur propre éditeur.
• Les LMS et outils pédagogiques qui ont besoin d'un signal de détection d'IA comme élément parmi d'autres d'un processus de relecture humaine, et non comme verdict automatique.
• Les services de correction et de relecture qui soumettent les brouillons de leurs clients à une première passe homogène avant la lecture par un correcteur.
• Les services de la recherche qui veulent vérifier des textes de demandes de financement ou des rapports par lots.

Si votre usage concerne des travaux d'étudiants, concevez-le de sorte que ce soient des personnes qui prennent les décisions finales. Le résultat d'un détecteur est un élément à examiner, et notre article sur ce qu'il faut considérer avant de mettre en doute la paternité d'un travail étudiant explique pourquoi.

Authentification, listes d'IP autorisées et limites de débit

Créez une clé sur /api une fois connecté. La clé n'est affichée qu'une seule fois, à sa création, et Academic Humanizer n'en conserve qu'un hachage : copiez-la directement dans votre gestionnaire de secrets ou une variable d'environnement côté serveur. Ne l'intégrez jamais dans du code exécuté dans un navigateur ou une application mobile.

Envoyez la clé dans l'en-tête X-API-Key. C'est l'en-tête recommandé par la documentation ; le serveur accepte aussi la clé comme jeton bearer dans l'en-tête Authorization.

Chaque requête passe ensuite quelques contrôles avant tout traitement du texte.

1. Vérification de la cléLa clé doit exister et être active, et le compte associé doit être actif.
2. Liste d'IP autoriséesEn mode restreint, seules les requêtes provenant des IP ou plages CIDR que vous avez listées sont acceptées.
3. Limite de débitLes requêtes au-delà de la limite par seconde de la clé sont rejetées avec un code HTTP 429.
4. TraitementLe texte est humanisé ou analysé, et les crédits sont vérifiés par rapport à votre solde.
5. Résultat enregistréLe résultat est enregistré dans votre compte et renvoyé au format JSON.

L'accès par IP comporte deux modes : public, où n'importe quelle IP peut appeler l'API avec une clé valide, et restreint, où seules les IP ou plages CIDR listées le peuvent. Le mode restreint mérite d'être activé pour tout serveur de production disposant d'une adresse de sortie fixe. La limite de débit par défaut est de 10 requêtes par seconde.

L'endpoint Humanize

Le corps de la requête est un JSON comportant un champ obligatoire, originalContent, et un champ facultatif, researchField. Si vous envoyez un domaine de recherche, il doit correspondre à l'un des noms pris en charge : Arts and Humanities, Social Sciences, Business and Economics, Engineering, Natural Sciences ou Medical and Health Sciences. Omettez-le ou envoyez null si vous n'en avez pas besoin.

curl -X POST https://academichumanizer.ai/api/v2/external/humanize   -H "Content-Type: application/json"   -H "X-API-Key: YOUR_API_KEY"   -d '{"originalContent": "Paste the paragraph or abstract to humanize here.", "researchField": "Natural Sciences"}'

Un appel réussi renvoie un code HTTP 201 avec un corps JSON contenant :

• humanizedText : le texte réécrit complet.
• changedCount : le nombre de phrases modifiées.
• sentences : un tableau d'entrées par phrase, chacune avec ses positions de début et de fin dans votre texte original, la phrase source, la phrase humanisée et un indicateur changed. Le tableau peut être vide.

L'identifiant du résultat enregistré est renvoyé dans l'en-tête de réponse X-Humanizer-Id, ce qui vous permet de relier une requête de votre système au résultat enregistré dans le compte de l'utilisateur. Notez que changed indique si une phrase a été réécrite ; ce n'est pas un verdict de détection d'IA. Pour cela, utilisez l'endpoint Detector.

Les positions des phrases facilitent l'affichage d'une comparaison dans votre propre interface : surlignez les segments modifiés et laissez l'utilisateur accepter ou retoucher chacun d'eux. Les utilisateurs doivent relire chaque résultat avant de s'en servir, car une réécriture par IA peut introduire des erreurs ou déplacer le sens.

L'endpoint Detector

L'endpoint Detector prend un seul champ obligatoire, text, jusqu'à 100 000 caractères. Il renvoie le statut de l'analyse, le nombre de caractères, le temps écoulé, une évaluation globale du document, les résultats des détecteurs et creditUsed. Les domaines de recherche ne sont pas utilisés ici.

Un schéma courant consiste à appeler d'abord Detector, à montrer à l'utilisateur les passages qui présentent des signaux, puis à n'appeler Humanize que sur les sections qu'il choisit. Cela réduit au minimum à la fois le coût et l'ampleur des modifications.

Comment les crédits de l'API sont comptés

Les deux endpoints consomment les crédits du compte propriétaire de la clé. Ils ne comptent pas de la même manière.

Humanize coûte 1 crédit pour 500 caractères, arrondi au supérieur par requête, et n'est facturé que lorsqu'un résultat complet est enregistré. Detector coûte 1 crédit pour 5 000 caractères, arrondi au supérieur. Si le solde est insuffisant, la requête échoue avec une erreur de crédits insuffisants au lieu de renvoyer un résultat partiel. Les formules et les packs sont décrits dans le fonctionnement des crédits et des tarifs, et les prix actuels figurent sur /pricing.

Les erreurs à gérer

Les corps d'erreur comportent un code court lisible par une machine : basez votre logique sur ce code plutôt que sur le texte du message.

Questions fréquentes

Comment obtenir une clé API ?

Connectez-vous et ouvrez /api. Créez une clé, copiez-la immédiatement (elle n'est affichée qu'une fois) et stockez-la sur votre serveur.

Puis-je limiter les serveurs autorisés à utiliser ma clé ?

Oui. Passez l'accès par IP en mode restreint et listez les IP ou plages CIDR autorisées à appeler l'API. Les requêtes provenant de tout autre endroit sont rejetées avec un code HTTP 403.

Existe-t-il une offre gratuite pour l'API ?

L'API utilise les mêmes crédits que l'application web. Les nouveaux comptes reçoivent 10 crédits gratuits une seule fois, ce qui suffit pour tester l'endpoint Humanize sur quelques courts passages.

Face à quels détecteurs le résultat est-il vérifié ?

Academic Humanizer est validé face à Turnitin, GPTZero, ZeroGPT, Copyleaks, Sapling et Originality.ai. Comme pour tout outil, les résultats varient selon le détecteur et aucune issue n'est garantie.

Développer avec Academic Humanizer

Si votre produit traite déjà des manuscrits, des résumés ou des travaux de cours, l'API vous permet d'ajouter une étape d'humanisation ou une vérification de détection sans renvoyer vos utilisateurs ailleurs. Commencez avec une clé de test, soumettez quelques vrais paragraphes aux deux endpoints, et lisez la documentation complète sur /docs avant de passer en production.