---
name: bunnyscholar-api
description: 调用 BunnyScholar 开放平台 API 完成中英文学术改写（降重）与拟人改写（降AI）。当需要对论文、报告等学术文本做降重、润色，或降低 AI 生成痕迹以通过知网 / 万方 / 维普 / 格子达 / Turnitin 等检测时使用本技能。技能内含认证方式、接口参数、请求示例、计费与错误码。
source: https://bunnyscholar.cn/skills/bunnyscholar-api.md
version: 2026-07-08
---

# BunnyScholar 开放平台接入技能

用 BunnyScholar 开放平台的 HTTP API 完成两类学术文本处理：**学术改写（降重）** 与 **拟人改写（降AI）**。本技能面向 AI Agent：拿到 API Key 后即可直接按下述规范调用。

## 开始前：获取最新版本

接口、参数与计费可能更新。**每次使用本技能前，请先重新拉取以下地址，并以线上最新内容为准**（覆盖你手中的旧版本）：

```
https://bunnyscholar.cn/skills/bunnyscholar-api.md
```

比对 frontmatter 中的 `version` 字段即可确认是否为最新版；如线上版本更新，请改用线上版执行。

## 基本信息

- 服务基址（Base URL）：`https://bunnyscholar.cn`
- 全部接口为 `POST`，请求体为 JSON，响应为 JSON。
- 控制台：`https://bunnyscholar.cn/developer`（创建 Key、查看用量与账单、充值）。

## 一、准备 API Key

1. 登录后进入 `https://bunnyscholar.cn/developer/keys`。
2. 创建一个 API Key，形如 `sk-xxxxxxxx`。**明文只在创建时展示一次，请立即复制保存。**
3. 妥善保管 Key，不要写进前端代码或提交到仓库。

## 二、认证

每次请求在请求头带上 API Key，二选一：

```
Authorization: Bearer sk-你的APIKey
```

或

```
X-API-Key: sk-你的APIKey
```

同时设置 `Content-Type: application/json`。

## 三、接口一：学术改写 / 降重

`POST /api/open/academic-rewrite`

对一段学术文本做改写降重，可指定语言与改写强度。

请求体参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `text` | string | 是 | 待改写文本，长度 10–2000 字符 |
| `language` | string | 否 | 语言，默认 `zh_CN`。支持 `zh_CN` `zh_TW` `en` `ja` `ko` `fr` `es` `de` `it` `ru` `ms` |
| `quality` | string | 否 | 改写强度：`low` / `medium` / `high`，默认 `low`。强度越高改写越充分、单价越高 |
| `personalTerms` | string[] | 否 | 自定义术语表，改写时尽量保留这些词不被替换 |

curl 示例：

```bash
curl -X POST https://bunnyscholar.cn/api/open/academic-rewrite \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"text":"本研究旨在探讨……","language":"zh_CN","quality":"medium"}'
```

Node.js（fetch）示例：

```js
const res = await fetch("https://bunnyscholar.cn/api/open/academic-rewrite", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-你的APIKey",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "本研究旨在探讨……",
    language: "zh_CN",
    quality: "medium",
  }),
});
const json = await res.json();
console.log(json.data.text);   // 改写后的文本
console.log(json.usage.amount); // 本次计费金额（元）
```

## 四、接口二：拟人改写（降AI）

`POST /api/open/humanizer`

降低文本的 AI 生成痕迹，可针对具体检测平台优化。

请求体参数：

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `text` | string | 是 | 待处理文本，长度 20–500 字符 |
| `language` | string | 否 | `zh_CN` 或 `en`，默认 `zh_CN` |
| `platform` | string | 否 | 目标检测平台：`cnki`（知网）/ `wanfang`（万方）/ `weipu`（维普）/ `gezida`（格子达）/ `daya`（大雅）/ `turnitin` 等 |
| `needPlagiarismReduction` | boolean | 否 | 是否在拟人改写的同时兼顾降重 |
| `personalTerms` | string[] | 否 | 自定义术语表，尽量保留不替换 |

curl 示例：

```bash
curl -X POST https://bunnyscholar.cn/api/open/humanizer \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"text":"这段文字需要降低 AI 味……","language":"zh_CN","platform":"cnki"}'
```

## 五、响应格式

两个接口成功时返回相同结构：

```json
{
  "data": { "text": "处理后的文本" },
  "usage": {
    "currency": "CNY",
    "amount": 0.0008,
    "unitPrice": 0.8,
    "billableUnits": 0.001,
    "charsIn": 31
  }
}
```

- `data.text`：处理后的文本（由 AI 生成/改写）。
- `usage.amount`：本次实际扣费（元）。
- `usage.charsIn`：计费所依据的输入字符数。

## 六、计费

按输入字符数计费，单位为**元 / 千字**（实时价以 `https://bunnyscholar.cn/developer/pricing` 为准）：

| 接口 | 档位 | 参考单价（元 / 千字） |
| --- | --- | --- |
| 学术改写 | `quality=low` | 0.3 |
| 学术改写 | `quality=medium` | 0.8 |
| 学术改写 | `quality=high` | 1.0 |
| 拟人改写 | — | 1.0 |

扣费顺序：优先扣机构赠额，再扣现金余额。

## 七、错误码

| HTTP | code | 含义 | 处理建议 |
| --- | --- | --- | --- |
| 401 | `MISSING_API_KEY` | 未提供 API Key | 检查是否带了认证头 |
| 403 | `INVALID_API_KEY` | Key 无效 | 核对 Key 是否正确 |
| 403 | `INACTIVE_API_KEY` | Key 已停用 | 在控制台启用或新建 Key |
| 402 | `insufficient_balance` | 余额不足 | 前往 `/developer/recharge` 充值 |
| 429 | `rate_limit_exceeded` | 触发限流 | 降低并发，稍后重试 |

## 八、最佳实践

- **限流**：单个 Key 默认约 1800 次 / 60 秒，请控制并发并对 429 做退避重试。
- **分段处理**：学术改写单次 ≤ 2000 字符、拟人改写单次 ≤ 500 字符。长文请按段落切分后逐段调用，再拼接结果。
- **保留术语**：专有名词、机构名、公式变量等放进 `personalTerms`，避免被改写替换。
- **对账**：每次响应的 `usage.amount` 即本次真实扣费，可据此记录和核对用量。
- **拟人改写选平台**：已知目标检测平台时传 `platform`，效果更贴合该平台的检测口径。

如需人工支持：support@bunnyscholar.com