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

/API

# Neuroslop API

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

[获取 API 密钥](https://neuroslop.net/#api-offers)
[端点](https://neuroslop.net/#endpoints)
[Markdown](https://neuroslop.net/zh/api.md)

## 适用对象

### 内容平台和CMS

在流程中筛选和质检文本：上线前标记机器生成内容，按需进行拟人化。

### 代理商和SEO工具

在您自己的产品下批量检查和拟人化。一个密钥，按单元计费，无需人工审批。

### 教育科技和写作工具

对提交内容评分，并为写作者提供基于精确标记的自查，而不是黑箱百分比。

## 为什么选择这个API

### 确定性检测

在输入、设置、引擎版本以及规则和词典快照相同时，网站的规则检查结果可以复现。

### 一键检测与修复

使用同一密钥进行检测和改写。分析适用时返回改写前后的分数；不可用的分数为 null。

### 考虑语言差异的结果

响应会说明分析是否适用。俄语和英语的正文规则最完善；其他语言的分析可能受限。

## 价格：单位

为应用、机器人和 MCP 提供 API 文本检查与改写。额度消耗取决于操作和文本长度。各套餐标明额度规则；现有密钥保留购买时的条款。

网站支持银行卡、SBP 或 USDT 支付，机器人支持 Telegram Stars。展示价格仅供参考，具体金额和币种以支付页面为准。

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

3,000单位套餐可完成3,000次检测，或100次标准版人性化，或30次高级版。检测权重为1，标准版每2500字符30，高级版每7500字符100。

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

## MCP 服务器

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

### neuroslop_check

检查AI写作特征、重复句式、节奏和文本结构。查看具体片段及结果说明。 通过托管的 HTTPS API 免费且无需 key；受防滥用频率限制。

### neuroslop_humanize

自然改写AI草稿：调整表达，使语言更自然，并通过版本对比核对重要细节。 只有 neuroslop_humanize 需要 API key。

### neuroslop_clean

去除隐藏字符：零宽空格、同形字符。本地运行，无需密钥。

### 如何连接

通过托管的 HTTPS API 免费且无需 key；受防滥用频率限制。 去除隐藏字符：零宽空格、同形字符。本地运行，无需密钥。 只有 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 无需 key 即可工作。

[连接你的代理 (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»: 用 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": "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
}
```

消耗的额度以 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/zh/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.