[Neuroslop](https://neuroslop.net/es/)

/API

# Neuroslop API

Integra detección, análisis detallado y humanización en tu aplicación o asistente de IA mediante API y MCP.

[Obtener una clave API](https://neuroslop.net/#api-offers)
[Endpoints](https://neuroslop.net/#endpoints)
[Markdown](https://neuroslop.net/es/api.md)

## Para quién es

### Plataformas de contenido y CMS

Filtra y controla calidad del texto en el proceso: marca el contenido generado por IA antes de publicar, humaniza bajo demanda.

### Agencias y herramientas SEO

Revisa y humaniza en lote con tu propio producto. Una clave, por unidades, sin aprobación manual.

### EdTech y herramientas de escritura

Puntúa textos y ofrece a los escritores una auto-revisión con los marcadores exactos, no un porcentaje de caja negra.

## Por qué esta API

### Verificaciones deterministas

La revisión por reglas del sitio es reproducible con la misma entrada, configuración, versión del motor e instantánea de reglas y diccionarios.

### Detecta y corrige con una sola clave

Comprueba y humaniza con una clave. Se devuelven puntuaciones antes/después cuando el análisis es aplicable; las no disponibles son null.

### Resultados según el idioma

La respuesta informa de la aplicabilidad. Las reglas de prosa están más desarrolladas para ruso e inglés; el análisis de otros idiomas puede ser limitado.

## Precios: unidades

Análisis y revisión por API para aplicaciones, bots y MCP. El consumo depende de la operación y la longitud del texto. Cada paquete indica sus condiciones; las claves existentes conservan las condiciones adquiridas.

Paga con tarjeta, SBP o USDT en la web, o con Telegram Stars en el bot. Los precios mostrados son orientativos; verás el importe y la moneda exactos en la pantalla de pago.

[Precios](https://neuroslop.net/en/pricing#apikeys)

Un paquete de 3.000 unidades son 3.000 verificaciones, o 100 humanizaciones Estándar, o 30 Premium. Las verificaciones pesan 1, Estándar 30 por cada 2500 caracteres, Premium 100 por 7500.

[Endpoints](https://neuroslop.net/#api-unit-costs)

## Servidor MCP

Conecta neuroslop a tu agente de IA mediante MCP, revisa el texto para detectar texto de baja calidad, lo humaniza y elimina caracteres ocultos por sí solo. Funciona en Claude Code, Cursor, Codex, OpenClaw.

### neuroslop_check

Comprueba señales de IA, construcciones recurrentes, ritmo y estructura. Consulta los fragmentos concretos y las explicaciones del resultado. Gratis y sin clave mediante la API alojada por HTTPS; se aplican límites contra abusos.

### neuroslop_humanize

Humaniza borradores de IA: cambia el enfoque, consigue un lenguaje más natural y compara versiones comprobando los detalles importantes. Solo neuroslop_humanize requiere una clave de API.

### neuroslop_clean

Elimina caracteres ocultos: espacios de ancho cero, homoglifos. Local, sin necesidad de clave.

### Cómo conectarse

Gratis y sin clave mediante la API alojada por HTTPS; se aplican límites contra abusos. Elimina caracteres ocultos: espacios de ancho cero, homoglifos. Local, sin necesidad de clave. Solo neuroslop_humanize requiere una clave de API.

Download [neuroslop-mcp.mjs](https://neuroslop.net/downloads/neuroslop-mcp.mjs) and add the config:

```
{
  "mcpServers": {
    "neuroslop": {
      "command": "node",
      "args": ["neuroslop-mcp.mjs"]
    }
  }
}
```

Sustituye la ruta absoluta. NEUROSLOP_API_KEY es opcional y solo se usa con neuroslop_humanize; neuroslop_check y neuroslop_clean funcionan sin clave.

[Conecta a tu agente (MCP)](https://neuroslop.net/mcp) [Obtén una clave en tu cuenta](https://neuroslop.net/account#api)

## Autenticación

MCP usa POST /api/check, gratuito y con límite de frecuencia. POST /v1/check requiere clave y consume sus unidades. GET /v1/health no necesita clave.

Para /v1/check, /v1/rewrite y /v1/balance, envía la clave en una cabecera: Authorization: Bearer <key> / X-API-Key: <key>.

Obtén una clave de dos formas, sin aprobación manual:

En el sitio — [tu cuenta → API](https://neuroslop.net/account#api): elige un paquete, paga con tarjeta, SBP o USDT — la clave se emite al instante.

En el bot de Telegram — [@AITextChecker_bot](https://t.me/AITextChecker_bot) → «🔌 API»: paga con Telegram Stars, la clave llega al chat.

## Precios: unidades

| Solicitud | units | Operación |
| --- | --- | --- |
| POST /v1/check | 1 | Análisis, aplicabilidad y hallazgos |
| POST /v1/rewrite tier=flash | 30 / 2500 UTF-16 | Humanización Standard |
| POST /v1/rewrite tier=pro | 100 / 7500 UTF-16 | Humanización Premium |

## POST/v1/check

Cuerpo: { "text": "...", "lang": "es" } (lang opcional). Hasta 20 000 caracteres.

Límite predeterminado de ambos métodos: 20 000 unidades de código UTF-16, incluidos los espacios. El servidor puede fijar un límite menor; GET /v1/health devuelve limits.maxInputChars y los errores too_long devuelven max.

Los ejemplos muestran campos seleccionados, no resultados medidos de clientes. Las puntuaciones y el saldo variarán.

```
curl -X POST https://neuroslop.net/v1/check \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"The team utilizes this checklist to review each draft before publication.","lang":"en"}'
```

Respuesta:

```
{
  "score": 100,
  "lang": "en",
  "ruleCoverage": "full",
  "scoreInterpretation": "style_rules_not_authorship",
  "applicability": { "status": "applicable", "eligible": true },
  "decision": {
    "outcome": "human_like",
    "action": "show_style_signal",
    "abstained": false,
    "confidence": null,
    "confidenceKind": "not_calibrated"
  },
  "assessment": {
    "outcome": "human_like",
    "authorshipProbability": null,
    "automaticRewrite": false
  },
  "remaining": 2999
}
```

Consulta applicability, decision y assessment antes de usar una puntuación. El valor 0–100 no es una probabilidad de autoría; null significa no disponible, no cero. lang describe el idioma del texto, no de la interfaz.

## POST/v1/rewrite

Cuerpo: { "text": "...", "tier": "flash", "lang": "en" }. tier es flash (Standard, predeterminado) o pro (Premium). /v1/health indica el límite de entrada.

```
curl -X POST https://neuroslop.net/v1/rewrite \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"text":"The team utilizes this checklist to review each draft before publication.","tier":"pro","lang":"en"}'
```

Respuesta:

```
{
  "text": "Your revised paragraph appears here.",
  "tier": "pro",
  "scoreBefore": 100,
  "scoreAfter": 100,
  "qualityBasis": "editorial_review",
  "spent": 100,
  "remaining": 2900
}
```

spent indica las unidades consumidas. La edición local y la devolución del original tienen spent=0, aunque cambie el texto. No deduzcas un cobro por cambios o puntuaciones.

qualityBasis describe la comprobación, no el cobro. Incluye editorial_review, deterministic, bounded-source-witness, unchanged y unverified; no es una lista cerrada. Una reescritura aceptada no tiene que subir la puntuación.

```
{
  "text": "The team uses this checklist to review each draft before publication.",
  "tier": "pro",
  "scoreBefore": 100,
  "scoreAfter": 100,
  "unchanged": false,
  "reason": "local_edited",
  "qualityBasis": "deterministic",
  "engine": "local-rules",
  "editorialApproved": false,
  "billable": false,
  "spent": 0,
  "remaining": 3000
}
```

```
{
  "text": "Original text is returned here.",
  "tier": "pro",
  "scoreBefore": null,
  "scoreAfter": null,
  "unchanged": true,
  "reason": "local_unchanged",
  "qualityBasis": "unchanged",
  "spent": 0,
  "remaining": 3000
}
```

Para reintentar de forma segura, envía una Idempotency-Key única con cada reescritura. La misma clave y solicitud reproducen la respuesta original sin otra reescritura ni cargo; una solicitud modificada devuelve 409. Esta opción conserva la respuesta final cifrada hasta 24 horas en una caché activa separada y excluida de las copias de seguridad gestionadas por la aplicación. Sin esta cabecera no se crea una caché de respuesta.

### replayOnly: true

Para recuperar sin iniciar trabajo, reutiliza Idempotency-Key, text, tier, lang y mode originales y añade replayOnly:true. Un recibo ausente o caducado devuelve 409 idempotency_replay_unavailable, no una nueva reescritura. Esto no prueba si se cobró la solicitud original. No reintentes automáticamente con una clave nueva.

```
curl -X POST https://neuroslop.net/v1/rewrite \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"text":"The team utilizes this checklist to review each draft before publication.","tier":"pro","lang":"en","replayOnly":true}'
```

## GET/v1/balance

Cuota restante de la clave: { plan, quota, used, remaining, resetMonth, perMinute }.

quotaMode: "one_time", resetMonth: null
Paquete de unidades de compra única. Sin recarga mensual.
quotaMode: "monthly"
Cuota mensual. Se renueva cada mes natural.

## GET/v1/health

Estado del servicio, sin clave: { "ok": true, "llm": true, "limits": { "maxInputChars": 20000 } }.

## Errores

Gestiona el error antes de usar el texto. Un tiempo de espera o 502 no prueba el estado del cobro: recupera el resultado guardado. No repitas a ciegas errores de autenticación, cuota o conflicto de clave.

| HTTP | error | Significado |
| --- | --- | --- |
| 401 | no_api_key / unknown_key / disabled | Clave ausente, no válida o desactivada |
| 429 | rate_limited / quota | Frecuencia de solicitudes o cuota de unidades excedida |
| 409 | idempotency_conflict / idempotency_in_progress | Clave reutilizada para otra solicitud o la original sigue en curso |
| 409 | idempotency_replay_unavailable / idempotency_receipt_corrupt | Resultado guardado no disponible; no iniciar trabajo nuevo automáticamente |
| 400 | text_required / too_long / bad_json / invalid_idempotency_key / invalid_replay_only / idempotency_key_required | Solicitud no válida; corrígela antes de reintentar |
| 413 | own_free_result_too_large | El resultado local supera el límite de respuesta; spent=0 |
| 502 | rewrite_error | Solicitud fallida; recupera el resultado guardado antes de iniciar trabajo nuevo |

[Obtener una clave API](https://neuroslop.net/#api-offers)

---
https://neuroslop.net/es/api

## api

- apikey_start: 4.5 USDT; units=3000; quotaMode=one_time.
- apikey_business: 14 USDT; units=11000; quotaMode=one_time.
- apikey_max: 36 USDT; units=30000; quotaMode=one_time.