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

/API

# Neuroslop API

Collega rilevamento, analisi dettagliata e umanizzazione alla tua app o assistente IA tramite API e MCP.

[Ottieni una chiave API](https://neuroslop.net/#api-offers)
[Endpoint](https://neuroslop.net/#endpoints)
[Markdown](https://neuroslop.net/it/api.md)

## Per chi è

### Piattaforme di contenuti e CMS

Filtra e controlla i testi nel flusso di lavoro: segnala il contenuto generato da AI prima della pubblicazione, umanizza su richiesta.

### Agenzie e strumenti SEO

Controlla e umanizza in blocco sotto il tuo prodotto. Una chiave, a consumo, nessuna approvazione manuale.

### EdTech e strumenti di scrittura

Valuta i testi e dai agli scrittori un autocontrollo con i marcatori esatti, non una percentuale inspiegabile.

## Perché questa API

### Controlli deterministici

Il controllo del sito basato su regole è riproducibile con lo stesso testo, le stesse impostazioni, la stessa versione del motore e la stessa istantanea di regole e dizionari.

### Rileva e correggi con una sola chiave

Verifica e umanizza con una chiave. I punteggi prima/dopo vengono restituiti quando applicabili; quelli non disponibili sono null.

### Risultati che tengono conto della lingua

La risposta indica l’applicabilità. Le regole per la prosa sono più sviluppate per russo e inglese; l’analisi delle altre lingue può essere limitata.

## Prezzi: unità

Analisi e revisione via API per app, bot e MCP. Il consumo dipende dall’operazione e dalla lunghezza del testo. Ogni pacchetto indica le condizioni; le chiavi esistenti conservano quelle acquistate.

Paga con carta, SBP o USDT sul sito, oppure con Telegram Stars nel bot. I prezzi indicati sono stime; l’importo e la valuta esatti compaiono nella schermata di pagamento.

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

Un pacchetto da 3.000 unità equivale a 3.000 controlli, o 100 umanizzazioni Standard, o 30 Premium. I controlli hanno peso 1, Standard 30 ogni 2500 caratteri, Premium 100 ogni 7500.

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

## Server MCP

Connetti neuroslop al tuo agente AI tramite MCP — controlla il testo per slop, lo umanizza e rimuove i caratteri nascosti da solo. Funziona in Claude Code, Cursor, Codex, OpenClaw.

### neuroslop_check

Verifica segnali IA, costruzioni ricorrenti, ritmo e struttura. Consulta i passaggi specifici e le spiegazioni del risultato. Gratuito e senza chiave tramite l’API ospitata su HTTPS; si applicano limiti antiabuso.

### neuroslop_humanize

Umanizza le bozze IA: cambia la presentazione, rendi la lingua più naturale e confronta le versioni controllando i dettagli importanti. Solo neuroslop_humanize richiede una chiave API.

### neuroslop_clean

Rimuove caratteri nascosti: spazi a larghezza zero, glifi omologhi. Locale, nessuna chiave necessaria.

### Come connettersi

Gratuito e senza chiave tramite l’API ospitata su HTTPS; si applicano limiti antiabuso. Rimuove caratteri nascosti: spazi a larghezza zero, glifi omologhi. Locale, nessuna chiave necessaria. Solo neuroslop_humanize richiede una chiave API.

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

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

Sostituisci il percorso assoluto. NEUROSLOP_API_KEY è facoltativa e viene usata solo da neuroslop_humanize; neuroslop_check e neuroslop_clean funzionano senza chiave.

[Connetti al tuo agente (MCP)](https://neuroslop.net/mcp) [Ottieni una chiave nel tuo account](https://neuroslop.net/account#api)

## Autenticazione

MCP usa POST /api/check, gratuito con limite di frequenza. POST /v1/check richiede una chiave e consuma le sue unità. GET /v1/health non richiede chiavi.

Per /v1/check, /v1/rewrite e /v1/balance, invia la chiave in un header: Authorization: Bearer <key> / X-API-Key: <key>.

Ottieni una chiave in due modi, senza approvazione manuale:

Sul sito — [il tuo account → API](https://neuroslop.net/account#api): scegli un pacchetto, paga con carta, SBP o USDT — la chiave arriva all'istante.

Nel bot Telegram — [@AITextChecker_bot](https://t.me/AITextChecker_bot) → «🔌 API»: paga con Telegram Stars, la chiave arriva in chat.

## Prezzi: unità

| Richiesta | unità | Operazione |
| --- | --- | --- |
| POST /v1/check | 1 | Analisi, applicabilità e rilievi |
| POST /v1/rewrite tier=flash | 30 / 2500 UTF-16 | Umanizzazione Standard |
| POST /v1/rewrite tier=pro | 100 / 7500 UTF-16 | Umanizzazione Premium |

## POST/v1/check

Corpo: { "text": "...", "lang": "it" } (lang opzionale). Fino a 20.000 caratteri.

Limite predefinito di entrambi i metodi: 20.000 unità di codice UTF-16, spazi inclusi. Il server può impostare un limite inferiore; GET /v1/health restituisce limits.maxInputChars e l'errore too_long restituisce max.

Gli esempi mostrano alcuni campi, non risultati misurati dei clienti. Punteggi e saldo possono variare.

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

Risposta:

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

Leggi applicability, decision e assessment prima del punteggio. Il valore 0–100 non è una probabilità di paternità; null significa non disponibile, non zero. lang descrive la lingua del testo, non dell’interfaccia.

## POST/v1/rewrite

Corpo: { "text": "...", "tier": "flash", "lang": "en" }. tier è flash (Standard, predefinito) o pro (Premium). /v1/health indica il limite di input.

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

Risposta:

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

spent indica le unità consumate. Una modifica locale o la restituzione dell’originale ha spent=0, anche se il testo cambia. Non dedurre addebiti da modifiche o punteggi.

qualityBasis descrive il controllo, non l’addebito. Include editorial_review, deterministic, bounded-source-witness, unchanged e unverified; l’elenco non è chiuso. Una riscrittura accettata non deve aumentare il punteggio.

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

Per ripetere le richieste in sicurezza, invia una Idempotency-Key univoca con ogni riscrittura. La stessa chiave e richiesta ripropongono la risposta originale senza un’altra riscrittura o addebito; una richiesta modificata restituisce 409. Questa opzione conserva la risposta finale cifrata fino a 24 ore in una cache attiva separata, esclusa dai backup gestiti dall’applicazione. Senza questa intestazione non viene creata alcuna cache della risposta.

### replayOnly: true

Per recuperare senza avviare lavoro, riusa Idempotency-Key, text, tier, lang e mode originali aggiungendo replayOnly:true. Una ricevuta assente o scaduta dà 409 idempotency_replay_unavailable, non una nuova riscrittura. Non dimostra se la richiesta originale è stata addebitata. Non riprovare automaticamente con una nuova chiave.

```
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

Quota residua della chiave: { plan, quota, used, remaining, resetMonth, perMinute }.

quotaMode: "one_time", resetMonth: null
Pacchetto di unità una tantum. Nessun rinnovo mensile.
quotaMode: "monthly"
Quota mensile. Si rinnova ogni mese di calendario.

## GET/v1/health

Stato del servizio, senza chiave: { "ok": true, "llm": true, "limits": { "maxInputChars": 20000 } }.

## Errori

Gestisci l’errore prima di usare il testo. Timeout o 502 non dimostrano lo stato dell’addebito: recupera il risultato salvato. Non ripetere alla cieca errori di autenticazione, quota o conflitto della chiave.

| HTTP | error | Significato |
| --- | --- | --- |
| 401 | no_api_key / unknown_key / disabled | Chiave assente, non valida o disattivata |
| 429 | rate_limited / quota | Frequenza delle richieste o quota di unità superata |
| 409 | idempotency_conflict / idempotency_in_progress | Chiave riutilizzata per un’altra richiesta o richiesta originale ancora in corso |
| 409 | idempotency_replay_unavailable / idempotency_receipt_corrupt | Risultato salvato non disponibile; non avviare nuovo lavoro automaticamente |
| 400 | text_required / too_long / bad_json / invalid_idempotency_key / invalid_replay_only / idempotency_key_required | Richiesta non valida; correggerla prima di riprovare |
| 413 | own_free_result_too_large | Il risultato locale supera il limite di risposta; spent=0 |
| 502 | rewrite_error | Richiesta fallita; recuperare il risultato salvato prima di avviare nuovo lavoro |

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

---
https://neuroslop.net/it/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.