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_hereGardez 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/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
}/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
lightModifications 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
aggressiveContournement 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
}
}/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-serverOuvrir 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.jsonAjouter 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_aiVérifier si un texte est généré par IA
humanizeTransformer du texte IA en texte humain
check_creditsVoir le solde de crédits restant
Agent Skills
Téléchargez les skills et placez chaque fichier dans le dossier de skills pris en charge par votre agent. Lisez les instructions avant de les installer.
