Referência da API

HumanizerAI API

Integre detecção de IA e humanização em suas aplicações com nossa simples REST API.

Início rápido

Obtenha uma chave API

Clique na sua foto de perfil → Configurações → Chaves API. Requer plano Pro ou Business.

Adicionar autorização

Inclua sua chave API no header Authorization como Bearer token.

Fazer requisições

Chame os endpoints detect ou humanize com seu conteúdo de texto.

Autenticação

Todas as requisições API requerem autenticação com uma chave API. Inclua sua chave no header Authorization como Bearer token:

Authorization: Bearer hum_your_api_key_here

Mantenha sua chave API segura

Nunca exponha sua chave API em código do lado do cliente ou repositórios públicos. Use variáveis de ambiente.

URL base

https://humanizerai.com/api/v1

POST

/detect

Analise texto para detectar se foi escrito por IA. Retorna uma pontuação de 0-100 (maior = mais provável IA) junto com métricas detalhadas.

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
text	string		O texto a analisar (máx. 10.000 palavras)

Exemplo de requisição

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

Resposta

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

Transforme texto gerado por IA em conteúdo natural e humano que contorna detectores de IA. Usa créditos baseados na contagem de palavras.

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
text	string		O texto a humanizar (máx. 10.000 palavras)
intensity	string	Opcional	`light`, `medium` ((padrão)), `aggressive` (bypass)

Níveis de intensidade

Leve

light

Mudanças sutis, preserva seu estilo. Melhor para textos com pontuações IA baixas.

Médio

medium(padrão)

Reescritas equilibradas com toques humanos. Melhor para a maioria dos casos.

Contornar

aggressive

Máximo contorno de detectores. O texto fica mais curto e simples.

Exemplo de requisição

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

Resposta

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

GET

/credits

Verifique seu saldo de créditos atual. Retorna créditos de assinatura, créditos de recarga e total disponível.

Exemplo de requisição

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

Resposta

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

Códigos de erro

Status	Mensagem	Descrição
400	Texto obrigatório	Parâmetro de texto ausente ou vazio
400	Texto excede o máximo	Texto excede o limite de 10.000 palavras
401	Chave API obrigatória	Header Authorization ausente
401	Chave API inválida ou revogada	Chave API não encontrada ou foi revogada
403	Acesso API requer Pro/Business	O plano do usuário não inclui acesso API
403	insufficient_credits	Créditos insuficientes para humanização
500	Erro do servidor	Erro interno do servidor

Limites de taxa

Plano	Chaves API	Limite de taxa	Máx. palavras/requisição
Pro	Até 3	60 requisições/minuto	10,000
Business	Até 10	300 requisições/minuto	10,000

MCP Server

O servidor MCP (Model Context Protocol) dá ao Claude Desktop acesso direto à detecção de IA e humanização. Peça ao Claude para verificar ou humanizar texto sem sair da sua conversa.

Instalar o servidor MCP

npm install -g @humanizerai/mcp-server

Abrir configuração do Claude Desktop

Abra o arquivo de configuração em:

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

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Adicionar HumanizerAI à configuração

Adicione isto ao seu claude_desktop_config.json:

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

Reiniciar Claude Desktop

Feche e reabra o Claude Desktop. Agora você pode pedir ao Claude para detectar ou humanizar texto!

Ferramentas disponíveis

detect_ai

Verificar se o texto é gerado por IA

humanize

Transformar texto IA em texto humano

check_credits

Ver saldo de créditos restante

Agent Skills

Ver no GitHub

As Agent Skills permitem detectar e humanizar texto IA diretamente do seu terminal com comandos slash simples. Funciona com Claude Code, Cursor, Windsurf e qualquer agente que suporte o formato Agent Skills.

Instalar a skill

Opção 1: comando /learn (recomendado)

/learn @humanizerai/humanize

Opção 2: Claude Code Plugin Marketplace

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

Opção 3: clonar do GitHub

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

Definir sua chave API

export HUMANIZERAI_API_KEY="hum_your_api_key"

Usar as skills

Execute estes comandos na sua sessão de agente:

Comandos disponíveis

/detect-ai [text]

Analisar texto e obter pontuação de detecção IA com métricas detalhadas

/humanize [text]

Transformar texto IA para contornar detectores (usa intensidade média)

/humanize --intensity aggressive [text]

Modo bypass máximo para conteúdo IA persistente

Agentes compatíveis

AMP

E qualquer agente que suporte o formato aberto Agent Skills.

Pronto para começar?

Cadastre-se para criar sua chave API e começar a integrar detecção de IA e humanização.