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

/API

# Neuroslop API

Підключіть детекцію, докладний розбір і гуманізацію до застосунку або AI-асистента через API та MCP.

[Отримати API-ключ](https://neuroslop.net/#api-offers)
[Ендпоінти](https://neuroslop.net/#endpoints)
[Markdown](https://neuroslop.net/uk/api.md)

## Для кого

### Контент-платформи та CMS

Перевіряй та контролюй текст у пайплайні: виявляй машинний шлак до публікації, гуманізуй на вимогу.

### Агенції та SEO-інструменти

Перевіряй та гуманізуй масово під твоїм продуктом. Один ключ, оплата за одиницю, без ручного затвердження.

### EdTech та інструменти для текстів

Оцінюй роботи та давай авторам самоперевірку з точними маркерами, а не відсоток із «чорного ящика».

## Чому цей API

### Детерміновані перевірки

Перевірка за правилами на сайті відтворюється для однакових тексту, налаштувань, версії рушія та знімка правил і словників.

### Виявлення та виправлення одним ключем

Перевірка й гуманізація з одним ключем. Бали до та після повертаються, коли оцінка застосовна; недоступний бал дорівнює null.

### Результати з урахуванням мови

Відповідь повідомляє застосовність аналізу. Правила для прози найрозвиненіші для російської та англійської; аналіз інших мов може бути обмежений.

## Ціни: юніти

Перевірка й редагування через API для застосунків, ботів і MCP. Витрати юнітів залежать від операції та довжини тексту. Умови квоти вказані для кожного пакета; наявні ключі зберігають придбані умови.

На сайті можна оплатити карткою, через СБП або в USDT, у боті — Telegram Stars. Ціни на сторінці орієнтовні; точну суму й валюту ви побачите під час оплати.

[Тарифи](https://neuroslop.net/en/pricing#apikeys)

Пакет на 3,000 одиниць — це 3,000 перевірок, або 100 гуманізацій Стандарт, або 30 Преміум. Вага: перевірка — 1, Стандарт — 30 за кожні 2500 знаків, Преміум — 100 за 7500.

[Ендпоінти](https://neuroslop.net/#api-unit-costs)

## Сервер MCP

Підключіть neuroslop до вашого AI-агента через MCP, він перевіряє текст на slop, гуманізує його та самостійно видаляє приховані символи. Працює в Claude Code, Cursor, Codex, OpenClaw.

### neuroslop_check

Перевіряйте ознаки AI-генерації, повторювані конструкції, ритм і структуру. Розбір показує конкретні фрагменти та пояснює результат. Безплатно й без ключа через хмарний API по HTTPS; діє антифлуд-ліміт.

### neuroslop_humanize

Гуманізуйте AI-чернетку: змінюйте подачу, робіть мову природнішою та порівнюйте версії з перевіркою важливих деталей. Лише neuroslop_humanize потребує API-ключа.

### neuroslop_clean

Видаляє приховані символи: пробіли нульової ширини, гомогліфи. Локально, ключ не потрібен.

### Як підключити

Безплатно й без ключа через хмарний API по HTTPS; діє антифлуд-ліміт. Видаляє приховані символи: пробіли нульової ширини, гомогліфи. Локально, ключ не потрібен. Лише neuroslop_humanize потребує API-ключа.

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

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

Замініть абсолютний шлях. NEUROSLOP_API_KEY необов’язковий і використовується лише neuroslop_humanize; neuroslop_check та neuroslop_clean працюють без ключа.

[Підключіть до вашого агента (MCP)](https://neuroslop.net/mcp) [Отримати ключ у вашому акаунті](https://neuroslop.net/account#api)

## Автентифікація

Перевірка MCP використовує безкоштовний POST /api/check з обмеженням частоти. POST /v1/check потребує ключа й витрачає його юніти. GET /v1/health доступний без ключа.

Для /v1/check, /v1/rewrite та /v1/balance передайте ключ у заголовку: Authorization: Bearer <key> / X-API-Key: <key>.

Отримати ключ можна двома способами, без ручного схвалення:

На сайті — [кабінет → API](https://neuroslop.net/account#api): обери пакет, оплати карткою, SBP чи USDT — ключ видається миттєво.

У Telegram-боті — [@AITextChecker_bot](https://t.me/AITextChecker_bot) → «🔌 API»: оплата зірками, ключ приходить у чат.

## Ціни: юніти

| Запит | units | Операція |
| --- | --- | --- |
| POST /v1/check | 1 | Аналіз, застосовність і зауваження |
| POST /v1/rewrite tier=flash | 30 / 2500 UTF-16 | Гуманізація Стандарт |
| POST /v1/rewrite tier=pro | 100 / 7500 UTF-16 | Гуманізація Преміум |

## POST/v1/check

Тіло: { "text": "...", "lang": "uk" } (lang необов'язковий). Текст до 20 000 символів.

Типовий ліміт обох методів — 20 000 кодових одиниць UTF-16, включно з пробілами. Сервер може встановити нижчу межу: GET /v1/health повертає limits.maxInputChars, помилка too_long — max.

Нижче показано окремі поля відповіді, а не виміряні результати клієнтів. Бали та залишок відрізнятимуться.

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

Відповідь:

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

Перед використанням бала перевірте applicability, decision та assessment. Бал 0–100 не є ймовірністю авторства; null означає відсутність оцінки, а не нуль. lang описує мову тексту, не інтерфейсу.

## POST/v1/rewrite

Тіло: { "text": "...", "tier": "flash", "lang": "en" }. tier: flash (Стандарт, типово) або pro (Преміум). Межу вводу повідомляє /v1/health.

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

Відповідь:

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

Витрачені юніти вказані в spent. Локальна правка й повернення оригіналу мають spent=0, навіть коли локальний алгоритм змінив текст. Не визначайте списання за змінами чи балами.

qualityBasis описує перевірку, не списання. Серед значень — editorial_review, deterministic, bounded-source-witness, unchanged та unverified; перелік не закритий. Схвалена редактура не зобов’язана підвищувати бал детектора.

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

Для безпечного повтору надсилайте унікальний Idempotency-Key з кожним редагуванням. Однакові ключ і запит повертають початкову відповідь без повторного редагування чи списання; змінений запит повертає 409. Лише з цим заголовком підсумкова відповідь зберігається зашифрованою до 24 годин в окремому робочому кеші, виключеному з резервних копій, якими керує застосунок. Без заголовка кеш відповіді не створюється.

### replayOnly: true

Щоб отримати збережений результат без запуску роботи, повторіть початкові Idempotency-Key, text, tier, lang і mode, додавши replayOnly:true. Відсутня або прострочена квитанція дає 409 idempotency_replay_unavailable, а не нову редактуру. Це не доводить, чи було списання в початковому запиті. Не повторюйте автоматично з новим ключем.

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

Залишок квоти ключа: { plan, quota, used, remaining, resetMonth, perMinute }.

quotaMode: "one_time", resetMonth: null
Разовий пакет юнітів. Без щомісячного поповнення.
quotaMode: "monthly"
Місячна квота. Оновлюється кожного календарного місяця.

## GET/v1/health

Живість сервісу, без ключа: { "ok": true, "llm": true, "limits": { "maxInputChars": 20000 } }.

## Помилки

Обробіть помилку перед використанням тексту. Таймаут або 502 не доводить статус списання: спробуйте відновити збережений результат. Не повторюйте наосліп помилки ключа, квоти чи конфлікту запитів.

| HTTP | error | Значення |
| --- | --- | --- |
| 401 | no_api_key / unknown_key / disabled | Ключ відсутній, неправильний або вимкнений |
| 429 | rate_limited / quota | Перевищено частоту запитів або квоту юнітів |
| 409 | idempotency_conflict / idempotency_in_progress | Ключ повторено з іншим запитом або початковий запит ще виконується |
| 409 | idempotency_replay_unavailable / idempotency_receipt_corrupt | Збережений результат недоступний; не запускайте нову роботу автоматично |
| 400 | text_required / too_long / bad_json / invalid_idempotency_key / invalid_replay_only / idempotency_key_required | Неправильний запит; виправте його перед повтором |
| 413 | own_free_result_too_large | Локальний результат перевищує межу відповіді; spent=0 |
| 502 | rewrite_error | Запит не виконано; спочатку спробуйте відновити збережений результат |

[Отримати API-ключ](https://neuroslop.net/#api-offers)

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