Riferimento API

HumanizerAI API

Integra il rilevamento IA e l'umanizzazione nelle tue applicazioni con la nostra semplice REST API.

Avvio rapido

Ottieni una chiave API

Clicca sulla tua immagine profilo → Impostazioni → Chiavi API. Richiede piano Pro o Business.

Aggiungi autorizzazione

Includi la tua chiave API nell'header Authorization come Bearer token.

Invia richieste

Chiama gli endpoint detect o humanize con il tuo contenuto testuale.

Autenticazione

Tutte le richieste API richiedono l'autenticazione con una chiave API. Includi la tua chiave nell'header Authorization come Bearer token:

Authorization: Bearer hum_your_api_key_here

Mantieni sicura la tua chiave API

Non esporre mai la tua chiave API nel codice lato client o nei repository pubblici. Usa le variabili d'ambiente.

URL base

https://humanizerai.com/api/v1

POST

/detect

Analizza il testo per rilevare se è stato scritto da IA. Restituisce un punteggio da 0-100 (più alto = più probabile IA) insieme a metriche dettagliate.

Corpo della richiesta

Parametro	Tipo	Obbligatorio	Descrizione
text	string		Il testo da analizzare (max 10.000 parole)

Esempio di richiesta

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..."
  }'

Risposta

{
  "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

Trasforma il testo generato da IA in contenuto naturale e umano che aggira i rilevatori IA. Usa crediti in base al conteggio parole.

Corpo della richiesta

Parametro	Tipo	Obbligatorio	Descrizione
text	string		Il testo da umanizzare (max 10.000 parole)
intensity	string	Opzionale	`light`, `medium` ((predefinito)), `aggressive` (bypass)

Livelli di intensità

Leggera

light

Modifiche sottili, preserva il tuo stile. Ideale per testi con punteggi IA bassi.

Media

medium(predefinito)

Riscritture bilanciate con tocco umano. Ideale per la maggior parte dei casi.

Aggiramento

aggressive

Massimo aggiramento dei rilevatori. Il testo diventa più breve e semplice.

Esempio di richiesta

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"
  }'

Risposta

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

GET

/credits

Controlla il tuo saldo crediti attuale. Restituisce crediti abbonamento, crediti ricarica e totale disponibile.

Esempio di richiesta

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

Risposta

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

Codici di errore

Stato	Messaggio	Descrizione
400	Testo obbligatorio	Parametro testo mancante o vuoto
400	Testo supera il massimo	Il testo supera il limite di 10.000 parole
401	Chiave API obbligatoria	Header Authorization mancante
401	Chiave API non valida o revocata	Chiave API non trovata o revocata
403	Accesso API richiede Pro/Business	Il piano dell'utente non include l'accesso API
403	insufficient_credits	Crediti insufficienti per l'umanizzazione
500	Errore del server	Errore interno del server

Limiti di frequenza

Piano	Chiavi API	Limite di frequenza	Max parole/richiesta
Pro	Fino a 3	60 richieste/minuto	10,000
Business	Fino a 10	300 richieste/minuto	10,000

MCP Server

Il server MCP (Model Context Protocol) offre a Claude Desktop accesso diretto al rilevamento IA e all'umanizzazione. Chiedi a Claude di verificare o umanizzare il testo senza uscire dalla conversazione.

Installa il server MCP

npm install -g @humanizerai/mcp-server

Apri la configurazione di Claude Desktop

Apri il file di configurazione in:

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

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Aggiungi HumanizerAI alla configurazione

Aggiungi questo al tuo claude_desktop_config.json:

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

Riavvia Claude Desktop

Chiudi e riapri Claude Desktop. Ora puoi chiedere a Claude di rilevare o umanizzare il testo!

Strumenti disponibili

detect_ai

Verifica se il testo è generato da IA

humanize

Trasforma testo IA in testo umano

check_credits

Visualizza saldo crediti rimanente

Agent Skills

Vedi su GitHub

Le Agent Skills ti permettono di rilevare e umanizzare il testo IA direttamente dal tuo terminale con semplici comandi slash. Funziona con Claude Code, Cursor, Windsurf e qualsiasi agente che supporta il formato Agent Skills.

Installa la skill

Opzione 1: comando /learn (consigliato)

/learn @humanizerai/humanize

Opzione 2: Claude Code Plugin Marketplace

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

Opzione 3: clona da GitHub

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

Imposta la tua chiave API

export HUMANIZERAI_API_KEY="hum_your_api_key"

Usa le skill

Esegui questi comandi nella tua sessione agente:

Comandi disponibili

/detect-ai [text]

Analizza il testo e ottieni il punteggio di rilevamento IA con metriche dettagliate

/humanize [text]

Trasforma testo IA per aggirare i rilevatori (usa intensità media)

/humanize --intensity aggressive [text]

Modalità bypass massima per contenuti IA ostinati

Agenti compatibili

AMP

E qualsiasi agente che supporta il formato aperto Agent Skills.

Pronto per iniziare?

Registrati per creare la tua chiave API e iniziare a integrare rilevamento IA e umanizzazione.