Referencia de la API

API de HumanizerAI

Integra la detección y humanización de IA en tus aplicaciones con nuestra sencilla REST API.

Inicio rápido

Obtén una clave de API

Haz clic en tu foto de perfil. Configuración. Claves de API. Requiere plan Pro o Business.

Añade la autorización

Incluye tu clave de API en el encabezado Authorization como Bearer token.

Realiza solicitudes

Llama a los endpoints de detección o humanización con tu contenido de texto.

Autenticación

Todas las solicitudes de la API requieren autenticación mediante una clave de API. Incluye tu clave en el encabezado Authorization como Bearer token:

Authorization: Bearer hum_your_api_key_here

Mantén tu clave de API segura

Nunca expongas tu clave de API en código del lado del cliente ni en repositorios públicos. Usa variables de entorno.

URL base

https://humanizerai.com/api/v1

POST

/detect

Analiza texto para detectar si fue escrito por IA. Devuelve una puntuación del 0 al 100 (mayor = más probable que sea IA) junto con métricas detalladas.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
text	string		El texto a analizar (máx. 10.000 palabras)

Ejemplo de solicitud

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

Respuesta

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

Transforma texto generado por IA en contenido natural y humano que evade los detectores de IA. Utiliza créditos según el número de palabras.

Cuerpo de la solicitud

Parámetro	Tipo	Requerido	Descripción
text	string		El texto a humanizar (máx. 10.000 palabras)
intensity	string	Opcional	`light`, `medium` ((predeterminado)), `aggressive` (bypass)

Niveles de intensidad

Ligero

light

Cambios sutiles que preservan tu estilo. Ideal para textos con puntuaciones de IA bajas.

Medio

medium(predeterminado)

Reescrituras equilibradas con toques humanos. Ideal para la mayoría de los casos.

Bypass

aggressive

Máxima evasión de detectores. El texto se vuelve más corto y sencillo.

Ejemplo de solicitud

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

Respuesta

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

GET

/credits

Consulta tu saldo de créditos actual. Devuelve créditos de suscripción, créditos adicionales y el total disponible.

Ejemplo de solicitud

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

Respuesta

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

Códigos de error

Estado	Mensaje	Descripción
400	Se requiere texto	Parámetro de texto faltante o vacío
400	El texto supera el máximo	El texto supera el límite de 10.000 palabras
401	Se requiere clave de API	Encabezado Authorization ausente
401	Clave de API inválida o revocada	La clave de API no se encontró o ha sido revocada
403	El acceso a la API requiere Pro/Business	El plan del usuario no incluye acceso a la API
403	insufficient_credits	Créditos insuficientes para la humanización
500	Error del servidor	Error interno del servidor

Límites de uso

Plan	Claves de API	Límite de uso	Máx. palabras/solicitud
Pro	Hasta 3	60 solicitudes/minuto	10,000
Business	Hasta 10	300 solicitudes/minuto	10,000

MCP Server

El servidor MCP (Model Context Protocol) le da a Claude Desktop acceso directo a la detección y humanización de IA. Pídele a Claude que verifique o humanice texto sin salir de tu conversación.

Instala el servidor MCP

npm install -g @humanizerai/mcp-server

Abre la configuración de Claude Desktop

Abre el archivo de configuración en:

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

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Añade HumanizerAI a tu configuración

Agrega esto a tu claude_desktop_config.json:

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

Reinicia Claude Desktop

Cierra y vuelve a abrir Claude Desktop. Ya puedes pedirle a Claude que detecte o humanice texto.

Herramientas disponibles

detect_ai

Comprueba si el texto fue generado por IA

humanize

Transforma texto de IA a estilo humano

check_credits

Consulta el saldo de créditos restante

Agent Skills

Ver en GitHub

Los Agent Skills te permiten detectar y humanizar texto de IA directamente desde tu terminal con simples comandos de barra. Funciona con Claude Code, Cursor, Windsurf y cualquier agente que soporte el formato Agent Skills.

Instala el skill

Opción 1: comando /learn (recomendado)

/learn @humanizerai/humanize

Opción 2: mercado de plugins de Claude Code

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

Opción 3: clonar desde GitHub

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

Configura tu clave de API

export HUMANIZERAI_API_KEY="hum_your_api_key"

Usa los skills

Ejecuta estos comandos en tu sesión de agente:

Comandos disponibles

/detect-ai [text]

Analiza texto y obtén una puntuación de detección de IA con métricas detalladas

/humanize [text]

Transforma texto de IA para evadir detectores (usa intensidad media)

/humanize --intensity aggressive [text]

Modo de bypass máximo para contenido con alta presencia de IA

Agentes compatibles

AMP

Y cualquier agente que soporte el formato abierto Agent Skills.

¿Listo para empezar?

Regístrate para crear tu clave de API y comenzar a integrar la detección y humanización de IA.