Référence API

API HumanizerAI

Intégrez la détection IA et l'humanisation dans vos applications avec notre REST API simple.

Démarrage rapide

Obtenir une clé API

Cliquez sur votre photo de profil. Paramètres. Clés API. Nécessite un plan Pro ou Business.

Ajouter l'autorisation

Incluez votre clé API dans l'en-tête Authorization en tant que Bearer token.

Effectuer des requêtes

Appelez les endpoints detect ou humanize avec le contenu de votre texte.

Authentification

Toutes les requêtes API nécessitent une authentification via une clé API. Incluez votre clé dans l'en-tête Authorization en tant que Bearer token :

Authorization: Bearer hum_your_api_key_here

Gardez votre clé API sécurisée

N'exposez jamais votre clé API dans du code côté client ou dans des dépôts publics. Utilisez des variables d'environnement.

URL de base

https://humanizerai.com/api/v1

POST

/detect

Analysez un texte pour détecter s'il a été rédigé par une IA. Renvoie un score de 0 à 100 (plus élevé = plus probablement IA) ainsi que des métriques détaillées.

Corps de la requête

Paramètre	Type	Requis	Description
text	string		Le texte à analyser (max 10 000 mots)

Exemple de requête

curl -X POST https://humanizerai.com/api/v1/detect \
  -H "Authorization: Bearer hum_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your text to analyze for AI detection..."
  }'

Réponse

{
  "score": 85,
  "metrics": {
    "perplexity": 42.5,
    "burstiness": 0.35,
    "readability": 65.2,
    "satPercent": 12.5,
    "simplicity": 78.3,
    "ngramScore": 0.15,
    "averageSentenceLength": 18.4
  },
  "verdict": "likely_ai",
  "wordsProcessed": 250
}

POST

/humanize

Transformez du texte généré par IA en contenu naturel et humain qui contourne les détecteurs IA. Utilise des crédits selon le nombre de mots.

Corps de la requête

Paramètre	Type	Requis	Description
text	string		Le texte à humaniser (max 10 000 mots)
intensity	string	Optionnel	`light`, `medium` ((défaut)), `aggressive` (bypass)

Niveaux d'intensité

Léger

light

Modifications subtiles, préserve votre style. Idéal pour les textes avec un faible score IA.

Moyen

medium(défaut)

Réécriture équilibrée avec des touches humaines. Idéal pour la plupart des cas.

Bypass

aggressive

Contournement maximal des détecteurs. Le texte devient plus court et plus simple.

Exemple de requête

curl -X POST https://humanizerai.com/api/v1/humanize \
  -H "Authorization: Bearer hum_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your AI-generated text to humanize...",
    "intensity": "medium"
  }'

Réponse

{
  "humanizedText": "The rewritten text that sounds human...",
  "score": {
    "before": 85,
    "after": 15
  },
  "wordsProcessed": 250,
  "credits": {
    "subscriptionRemaining": 49750,
    "topUpRemaining": 0,
    "totalRemaining": 49750
  }
}

GET

/credits

Vérifiez votre solde de crédits actuel. Renvoie les crédits d'abonnement, les crédits rechargés et le total disponible.

Exemple de requête

curl https://humanizerai.com/api/v1/credits \
  -H "Authorization: Bearer hum_your_api_key"

Réponse

{
  "credits": {
    "subscription": 45000,
    "topUp": 5000,
    "total": 50000
  },
  "plan": "pro",
  "billingCycleEnd": "2025-02-15T00:00:00.000Z"
}

Codes d'erreur

Statut	Message	Description
400	Le texte est requis	Paramètre texte manquant ou vide
400	Le texte dépasse le maximum	Le texte dépasse la limite de 10 000 mots
401	Clé API requise	En-tête Authorization manquant
401	Clé API invalide ou révoquée	Clé API introuvable ou révoquée
403	L'accès API nécessite Pro/Business	Le plan de l'utilisateur n'inclut pas l'accès API
403	insufficient_credits	Crédits insuffisants pour l'humanisation
500	Erreur serveur	Erreur interne du serveur

Limites de débit

Plan	Clés API	Limite de débit	Mots max/requête
Pro	Jusqu'à 3	60 requêtes/minute	10,000
Business	Jusqu'à 10	300 requêtes/minute	10,000

MCP Server

Le serveur MCP (Model Context Protocol) donne à Claude Desktop un accès direct à la détection IA et à l'humanisation. Demandez à Claude de vérifier ou d'humaniser du texte sans quitter votre conversation.

Installer le serveur MCP

npm install -g @humanizerai/mcp-server

Ouvrir la configuration de Claude Desktop

Ouvrez le fichier de configuration à :

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Ajouter HumanizerAI à votre configuration

Ajoutez ceci à votre claude_desktop_config.json :

{
  "mcpServers": {
    "humanizerai": {
      "command": "humanizerai-mcp",
      "env": {
        "HUMANIZERAI_API_KEY": "hum_your_api_key"
      }
    }
  }
}

Redémarrer Claude Desktop

Fermez et rouvrez Claude Desktop. Vous pouvez maintenant demander à Claude de détecter ou d'humaniser du texte.

Outils disponibles

detect_ai

Vérifier si un texte est généré par IA

humanize

Transformer du texte IA en texte humain

check_credits

Voir le solde de crédits restant

Agent Skills

Voir sur GitHub

Les Agent Skills vous permettent de détecter et d'humaniser du texte IA directement depuis votre terminal avec des commandes slash simples. Compatible avec Claude Code, Cursor, Windsurf et tout agent supportant le format Agent Skills.

Installer le skill

Option 1 : commande /learn (recommandée)

/learn @humanizerai/humanize

Option 2 : place de marché de plugins Claude Code

# In Claude Code, run:
/plugin marketplace add humanizerai/agent-skills
/plugin install detect-ai@humanizerai
/plugin install humanize@humanizerai

Option 3 : cloner depuis GitHub

git clone https://github.com/humanizerai/agent-skills.git .claude/skills/humanizerai

Définir votre clé API

export HUMANIZERAI_API_KEY="hum_your_api_key"

Utiliser les skills

Exécutez ces commandes dans votre session agent :

Commandes disponibles

/detect-ai [text]

Analyser un texte et obtenir le score de détection IA avec des métriques détaillées

/humanize [text]

Transformer du texte IA pour contourner les détecteurs (intensité moyenne)

/humanize --intensity aggressive [text]

Mode bypass maximal pour les contenus très détectés

Agents compatibles

AMP

Et tout agent supportant le format ouvert Agent Skills.

Prêt à commencer ?

Inscrivez-vous pour créer votre clé API et commencer à intégrer la détection IA et l'humanisation.