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

/API

# Neuroslop API

تشخیص، تحلیل دقیق و طبیعی‌سازی را با API و MCP به برنامه یا دستیار هوش مصنوعی وصل کن.

[دریافت کلید API](https://neuroslop.net/#api-offers)
[اندپوینت‌ها](https://neuroslop.net/#endpoints)
[Markdown](https://neuroslop.net/fa/api.md)

## برای کیه

### پلتفرم‌های محتوایی و CMS

متن‌ها رو توی پایپ‌لاین غربال و کنترل کیفیت کن: متن ماشینی رو قبل از انتشار پرچم‌گذاری کن، در صورت نیاز انسانی‌سازی کن.

### آژانس‌ها و ابزارهای سئو

بررسی و انسانی‌سازی انبوه زیر برند خودت. یه کلید، بر اساس واحد، بدون تأیید دستی.

### آموزش آنلاین و ابزارهای نگارش

ارسال‌ها رو نمره‌بندی کن و به نویسندگان امکان خودبررسی با نشانه‌های دقیق بده، نه یه درصد جعبه سیاه.

## چرا این API

### بررسی‌های قطعی

بررسی قاعده‌محور سایت با ورودی، تنظیمات، نسخهٔ موتور و تصویر ثابت قواعد و واژه‌نامه‌های یکسان بازتولیدپذیر است.

### تشخیص و رفع با یک کلید

با یک کلید بررسی و بازنویسی کنید. امتیازهای پیش و پس از ویرایش در صورت کاربرد تحلیل برمی‌گردند؛ امتیاز ناموجود null است.

### نتایج با در نظر گرفتن زبان

پاسخ، قابلیت اعمال تحلیل را گزارش می‌کند. قواعد نثر برای روسی و انگلیسی توسعه‌یافته‌ترند؛ تحلیل زبان‌های دیگر ممکن است محدود باشد.

## قیمت: واحدها

بررسی و ویرایش متن از طریق API برای برنامه‌ها، ربات‌ها و MCP. مصرف واحد به عملیات و طول متن بستگی دارد. شرایط سهمیه برای هر بسته درج شده و کلیدهای موجود شرایط خرید خود را حفظ می‌کنند.

در سایت با کارت، SBP یا USDT و در بات با Telegram Stars پرداخت کنید. قیمت‌های نمایش‌داده‌شده تقریبی‌اند؛ مبلغ دقیق و ارز در صفحهٔ پرداخت مشخص می‌شود.

[قیمت‌گذاری](https://neuroslop.net/en/pricing#apikeys)

بسته ۳۰۰۰ واحدی یعنی ۳۰۰۰ بررسی، یا ۱۰۰ انسانی‌سازی استاندارد، یا ۳۰ پریمیوم. وزن بررسی ۱، استاندارد ۳۰ به‌ازای هر ۲۵۰۰ نویسه، پریمیوم ۱۰۰ به‌ازای هر ۷۵۰۰.

[اندپوینت‌ها](https://neuroslop.net/#api-unit-costs)

## سرور MCP

نورواسلاپ را از طریق MCP به ایجنت هوش مصنوعی خود وصل کنید — متن را از نظر اسلپ بررسی می‌کند، انسانی‌سازی می‌کند و کاراکترهای مخفی را خودش حذف می‌کند. در Claude Code، Cursor، Codex و OpenClaw کار می‌کند.

### neuroslop_check

نشانه‌های هوش مصنوعی، ساختارهای تکراری، آهنگ و ساختار متن را بررسی کن. بخش‌های مشخص و توضیح نتیجه را ببین. رایگان و بدون کلید از طریق API میزبانی‌شده روی HTTPS؛ محدودیت نرخ برای جلوگیری از سوءاستفاده اعمال می‌شود.

### neuroslop_humanize

پیش‌نویس هوش مصنوعی را بازنویسی کن، زبان را طبیعی‌تر کن و نسخه‌ها را با بررسی جزئیات مهم مقایسه کن. فقط neuroslop_humanize به API key نیاز دارد.

### neuroslop_clean

کاراکترهای مخفی رو حذف می‌کنه: فاصله‌های بدون عرض، همگلیف‌ها. محلی، نیازی به کلید نیست.

### نحوه اتصال

رایگان و بدون کلید از طریق API میزبانی‌شده روی HTTPS؛ محدودیت نرخ برای جلوگیری از سوءاستفاده اعمال می‌شود. کاراکترهای مخفی رو حذف می‌کنه: فاصله‌های بدون عرض، همگلیف‌ها. محلی، نیازی به کلید نیست. فقط neuroslop_humanize به API key نیاز دارد.

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 بپرداز — کلید فوری صادر می‌شود.

در بات تلگرام — [@AITextChecker_bot](https://t.me/AITextChecker_bot) → «🔌 API»: با Telegram Stars بپرداز، کلید به چت می‌آید.

## قیمت: واحدها

| درخواست | واحدها | عملیات |
| --- | --- | --- |
| POST /v1/check | 1 | تحلیل، کاربرد و یافته‌ها |
| POST /v1/rewrite tier=flash | 30 / 2500 UTF-16 | بازنویسی طبیعی Standard |
| POST /v1/rewrite tier=pro | 100 / 7500 UTF-16 | بازنویسی طبیعی Premium |

## POST/v1/check

بدنه: { "text": "...", "lang": "fa" } (lang اختیاری). تا ۲۰۰۰۰ نویسه.

سقف پیش‌فرض هر دو روش ۲۰٬۰۰۰ واحد کد 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 ‏(Standard، پیش‌فرض) یا pro ‏(Premium) است. /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 می‌گیرد. این گزینه پاسخ نهایی را تا ۲۴ ساعت به‌صورت رمزگذاری‌شده در حافظهٔ نهان فعال و جداگانه نگه می‌دارد که از نسخه‌های پشتیبان تحت مدیریت برنامه کنار گذاشته شده است. بدون این سرآیند حافظهٔ نهان پاسخ ساخته نمی‌شود.

### 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/fa/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.