Neuroslop API

通过API和MCP将检测、详细分析和自然改写接入你的应用或AI助手。

适用对象

为什么选择这个API

MCP 服务器

通过 MCP 将 neuroslop 连接到你的 AI 代理，它自动检查文本中的垃圾内容，进行拟人化改写，并去除隐藏字符。适用于 Claude Code, Cursor, Codex, OpenClaw。

如何连接

1. 通过托管的 HTTPS API 免费且无需 key；受防滥用频率限制。 去除隐藏字符：零宽空格、同形字符。本地运行，无需密钥。 只有 neuroslop_humanize 需要 API key。
2. Download neuroslop-mcp.mjs and add the config:

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

3. 请替换绝对路径。NEUROSLOP_API_KEY 为可选项，仅供 neuroslop_humanize 使用；neuroslop_check 和 neuroslop_clean 无需 key 即可工作。

连接你的代理 (MCP) 在你的账户中获取密钥

认证

MCP 使用免费且限流的 POST /api/check。POST /v1/check 需要密钥并消耗其额度。GET /v1/health 无需密钥。

调用 /v1/check、/v1/rewrite 和 /v1/balance 时，请在请求头中发送密钥：Authorization: Bearer <key> / X-API-Key: <key>.

两种方式获取密钥，无需人工审批：

• 在网站上 — 我的账户 → API: 选套餐，用银行卡、SBP 或 USDT 支付——密钥即刻发放。
• 在 Telegram 机器人里 — @AITextChecker_bot → «🔌 API»: 用 Telegram Stars 支付，密钥直接发到聊天。

价格：单位

POST/v1/check

请求体: { "text": "...", "lang": "zh" } （lang 可选）。 最多 20000 字符。

两个接口的默认上限为 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（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
}

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
}

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 不能证明扣费状态：请尝试取回已保存的结果。不要盲目重试认证、额度或请求键冲突错误。