Neuroslop API

Hubungkan pengesanan, analisis terperinci dan humanisasi ke aplikasi atau pembantu AI melalui API dan MCP.

Untuk siapa

Mengapa API ini

Pelayan MCP

Sambung neuroslop ke agen AI kamu melalui MCP — ia memeriksa teks untuk sampah, menjadikannya manusiawi dan membuang aksara tersembunyi secara automatik. Berfungsi dalam Claude Code, Cursor, Codex, OpenClaw.

Cara menyambung

1. Percuma dan tanpa key melalui API HTTPS yang dihoskan; had kadar anti-penyalahgunaan dikenakan. Membuang aksara tersembunyi: ruang lebar sifar, homoglif. Tempatan, tanpa kunci. Hanya neuroslop_humanize memerlukan API key.
2. Download neuroslop-mcp.mjs and add the config:

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

3. Gantikan laluan mutlak. NEUROSLOP_API_KEY adalah pilihan dan hanya digunakan oleh neuroslop_humanize; neuroslop_check dan neuroslop_clean berfungsi tanpa key.

Sambung ke agen kamu (MCP) Dapatkan kunci dalam akaun kamu

Pengesahan

MCP menggunakan POST /api/check percuma dengan had kadar. POST /v1/check memerlukan key dan menggunakan unitnya. GET /v1/health tidak memerlukan key.

Untuk /v1/check, /v1/rewrite dan /v1/balance, hantar key dalam header: Authorization: Bearer <key> / X-API-Key: <key>.

Dapatkan kunci dua cara, tanpa kelulusan manual:

• Di laman — akaun anda → API: pilih pakej, bayar dengan kad, SBP atau USDT — kunci dikeluarkan serta-merta.
• Dalam bot Telegram — @AITextChecker_bot → «🔌 API»: bayar dengan Telegram Stars, kunci tiba di sembang.

Harga: unit

POST/v1/check

Badan: { "text": "...", "lang": "ms" } (lang pilihan). Sehingga 20,000 aksara.

Had lalai kedua-dua kaedah: 20,000 unit kod UTF-16, termasuk ruang. Pelayan boleh menetapkan had lebih rendah; GET /v1/health melaporkan limits.maxInputChars dan ralat too_long melaporkan max.

Contoh menunjukkan medan respons terpilih, bukan hasil pelanggan yang diukur. Skor dan baki akan berbeza.

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

Respons:

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

Baca applicability, decision dan assessment sebelum menggunakan skor. Skor 0–100 bukan kebarangkalian kepengarangan; null bermaksud tidak tersedia, bukan sifar. lang ialah bahasa teks, bukan antara muka.

POST/v1/rewrite

Body: { "text": "...", "tier": "flash", "lang": "en" }. tier ialah flash (Standard, lalai) atau pro (Premium). /v1/health melaporkan had 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"}'

Respons:

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

qualityBasis menerangkan semakan, bukan caj. Nilainya termasuk editorial_review, deterministic, bounded-source-witness, unchanged dan unverified; senarai tidak tertutup. Suntingan diterima tidak perlu menaikkan skor.

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

replayOnly: true

Untuk mengambil hasil tersimpan tanpa kerja baharu, gunakan Idempotency-Key, text, tier, lang dan mode asal dengan replayOnly:true. Rekod yang tiada atau tamat tempoh memberi 409 idempotency_replay_unavailable, bukan suntingan baharu. Ini tidak membuktikan sama ada permintaan asal dicaj. Jangan cuba key baharu secara automatik.

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

Baki kuota kunci: { plan, quota, used, remaining, resetMonth, perMinute }.

quotaMode: "one_time", resetMonth: null

Pakej unit sekali beli. Tiada tambah nilai bulanan.

quotaMode: "monthly"

Kuota bulanan. Diperbaharui setiap bulan kalendar.

GET/v1/health

Status perkhidmatan, tanpa kunci: { "ok": true, "llm": true, "limits": { "maxInputChars": 20000 } }.

Ralat

Kendalikan ralat sebelum menggunakan teks. Timeout atau 502 tidak membuktikan status caj: pulihkan hasil tersimpan. Jangan ulang ralat pengesahan, kuota atau konflik key secara membuta tuli.