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